@ricsam/quickjs-fetch 0.2.7 → 0.2.9

package/dist/mjs/setup.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/setup.ts"],
   "sourcesContent": [
-    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport { setupCore, createStateMap, createReadableStream } from \"@ricsam/quickjs-core\";\nimport type { SetupFetchOptions, FetchHandle, ServeState } from \"./types.mjs\";\nimport { createHeadersClass } from \"./globals/headers.mjs\";\nimport { createRequestClass, addRequestFormDataMethod } from \"./globals/request.mjs\";\nimport { createResponseClass, addResponseStaticMethods } from \"./globals/response.mjs\";\nimport { setupAbortControllerAndSignal } from \"./globals/abort-controller.mjs\";\nimport { createFormDataClass, addFormDataFileMethods } from \"./globals/form-data.mjs\";\nimport { createFetchFunction } from \"./globals/fetch.mjs\";\nimport {\n  createServeFunction,\n  createServerClass,\n  createServerWebSocketClass,\n} from \"./globals/serve.mjs\";\nimport { createFetchHandle } from \"./handle.mjs\";\n\n/**\n * Setup Fetch API in a QuickJS context\n *\n * Injects the following globals:\n * - fetch\n * - Request\n * - Response\n * - Headers\n * - AbortController\n * - AbortSignal\n * - serve\n * - FormData\n *\n * Also sets up Core APIs (Streams, Blob, File) if not already present.\n *\n * **Private globals (internal use):**\n * - `__Server__` - Server class for serve() handler, instantiated via evalCode\n * - `__ServerWebSocket__` - WebSocket class for connection handling\n * - `__scheduleTimeout__` - Host function to schedule AbortSignal.timeout()\n * - `__checkTimeout__` - Host function to check if timeout elapsed\n *\n * These private globals follow the `__Name__` convention and are required for\n * JavaScript code in QuickJS to create class instances via evalCode.\n * See PATTERNS.md section 5 for details.\n *\n * @example\n * const handle = setupFetch(context, {\n *   onFetch: async (request) => {\n *     // Proxy to real fetch\n *     return fetch(request);\n *   }\n * });\n *\n * context.evalCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `);\n *\n * const response = await handle.dispatchRequest(\n *   new Request(\"http://localhost/\")\n * );\n */\nexport function setupFetch(\n  context: QuickJSContext,\n  options: SetupFetchOptions = {}\n): FetchHandle {\n  // Setup core if not already done\n  const coreHandle =\n    options.coreHandle ??\n    setupCore(context, {\n      stateMap: options.stateMap,\n    });\n\n  const stateMap = options.stateMap ?? coreHandle.stateMap;\n\n  // Create serve state\n  const serveState: ServeState = {\n    fetchHandler: null,\n    websocketHandlers: {},\n    pendingUpgrade: null,\n    activeConnections: new Map(),\n  };\n\n  // WebSocket command dispatcher\n  const wsCommandCallbacks = new Set<\n    (cmd: import(\"./types.mjs\").WebSocketCommand) => void\n  >();\n  const dispatchWsCommand = (cmd: import(\"./types.mjs\").WebSocketCommand) => {\n    for (const cb of wsCommandCallbacks) {\n      cb(cmd);\n    }\n  };\n\n  // Create stream factory for Request/Response body\n  const streamFactory = (source: UnderlyingSource) =>\n    createReadableStream(context, stateMap, source);\n\n  // Create Headers class\n  const HeadersClass = createHeadersClass(context, stateMap);\n  context.setProp(context.global, \"Headers\", HeadersClass);\n  HeadersClass.dispose();\n\n  // Add Symbol.iterator support for Headers (for...of, Array.from, spread)\n  const iteratorResult = context.evalCode(`\n    Headers.prototype[Symbol.iterator] = function() {\n      return this.entries()[Symbol.iterator]();\n    };\n  `);\n  if (iteratorResult.error) {\n    iteratorResult.error.dispose();\n  } else {\n    iteratorResult.value.dispose();\n  }\n\n  // Create Request class\n  const RequestClass = createRequestClass(context, stateMap, streamFactory);\n  context.setProp(context.global, \"Request\", RequestClass);\n  RequestClass.dispose();\n\n  // Create Response class\n  const ResponseClass = createResponseClass(context, stateMap, streamFactory);\n  context.setProp(context.global, \"Response\", ResponseClass);\n  ResponseClass.dispose();\n\n  // Add Response static methods (must be after Response and Headers are on global)\n  addResponseStaticMethods(context);\n\n  // Create AbortSignal and AbortController classes (pure QuickJS implementation)\n  setupAbortControllerAndSignal(context);\n\n  // Create FormData class\n  const FormDataClass = createFormDataClass(context, stateMap);\n  context.setProp(context.global, \"FormData\", FormDataClass);\n  FormDataClass.dispose();\n\n  // Add Symbol.iterator support for FormData (for...of, Array.from, spread)\n  const formDataIteratorResult = context.evalCode(`\n    FormData.prototype[Symbol.iterator] = function() {\n      return this.entries()[Symbol.iterator]();\n    };\n  `);\n  if (formDataIteratorResult.error) {\n    formDataIteratorResult.error.dispose();\n  } else {\n    formDataIteratorResult.value.dispose();\n  }\n\n  // Add Request.formData() method that returns a proper FormData instance\n  // Must be after both Request and FormData are on global\n  addRequestFormDataMethod(context);\n\n  // Add FormData.get()/getAll() overrides to reconstruct File instances\n  // Must be after both FormData and File are on global\n  addFormDataFileMethods(context);\n\n  // Create ServerWebSocket class (internal, for WebSocket handling)\n  const ServerWebSocketClass = createServerWebSocketClass(\n    context,\n    stateMap,\n    dispatchWsCommand\n  );\n  // Set on global with internal name so we can use evalCode to instantiate\n  context.setProp(context.global, \"__ServerWebSocket__\", ServerWebSocketClass);\n  ServerWebSocketClass.dispose();\n  // Note: ServerWebSocketClass handle is now owned by global\n\n  // Create Server class (internal, passed to fetch handler)\n  const ServerClass = createServerClass(context, stateMap, serveState);\n  // Set on global with internal name so we can use evalCode to instantiate\n  context.setProp(context.global, \"__Server__\", ServerClass);\n  ServerClass.dispose();\n  // Note: ServerClass handle is now owned by global\n\n  // Create fetch function\n  const fetchFn = createFetchFunction(context, options.onFetch);\n  context.setProp(context.global, \"fetch\", fetchFn);\n  fetchFn.dispose();\n\n  // Create serve function\n  const serveFn = createServeFunction(context, stateMap, serveState);\n  context.setProp(context.global, \"serve\", serveFn);\n  serveFn.dispose();\n\n  // Create and return the handle\n  const fetchHandle = createFetchHandle(\n    context,\n    stateMap,\n    serveState\n  );\n\n  // Wire up WebSocket command callbacks\n  const originalOnWebSocketCommand = fetchHandle.onWebSocketCommand;\n  fetchHandle.onWebSocketCommand = (callback) => {\n    wsCommandCallbacks.add(callback);\n    return () => wsCommandCallbacks.delete(callback);\n  };\n\n  return fetchHandle;\n}\n"
+    "import type { QuickJSContext, QuickJSHandle } from \"quickjs-emscripten\";\nimport { setupCore, createStateMap, createReadableStream } from \"@ricsam/quickjs-core\";\nimport type { SetupFetchOptions, FetchHandle, ServeState } from \"./types.mjs\";\nimport { createHeadersClass } from \"./globals/headers.mjs\";\nimport { createRequestClass, addRequestFormDataMethod } from \"./globals/request.mjs\";\nimport { createResponseClass, addResponseStaticMethods } from \"./globals/response.mjs\";\nimport { setupAbortControllerAndSignal } from \"./globals/abort-controller.mjs\";\nimport { createFormDataClass, addFormDataFileMethods } from \"./globals/form-data.mjs\";\nimport { createFetchFunction } from \"./globals/fetch.mjs\";\nimport {\n  createServeFunction,\n  createServerClass,\n  createServerWebSocketClass,\n} from \"./globals/serve.mjs\";\nimport { createFetchHandle } from \"./handle.mjs\";\n\n/**\n * Setup Fetch API in a QuickJS context\n *\n * Injects the following globals:\n * - fetch\n * - Request\n * - Response\n * - Headers\n * - AbortController\n * - AbortSignal\n * - serve\n * - FormData\n *\n * Also sets up Core APIs (Streams, Blob, File) if not already present.\n *\n * **Private globals (internal use):**\n * - `__Server__` - Server class for serve() handler, instantiated via evalCode\n * - `__ServerWebSocket__` - WebSocket class for connection handling\n * - `__scheduleTimeout__` - Host function to schedule AbortSignal.timeout()\n * - `__checkTimeout__` - Host function to check if timeout elapsed\n *\n * These private globals follow the `__Name__` convention and are required for\n * JavaScript code in QuickJS to create class instances via evalCode.\n * See PATTERNS.md section 5 for details.\n *\n * @example\n * const handle = setupFetch(context, {\n *   onFetch: async (request) => {\n *     // Proxy to real fetch\n *     return fetch(request);\n *   }\n * });\n *\n * context.evalCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `);\n *\n * const response = await handle.dispatchRequest(\n *   new Request(\"http://localhost/\")\n * );\n */\nexport function setupFetch(\n  context: QuickJSContext,\n  options: SetupFetchOptions = {}\n): FetchHandle {\n  // Setup core if not already done\n  const coreHandle =\n    options.coreHandle ??\n    setupCore(context, {\n      stateMap: options.stateMap,\n    });\n\n  const stateMap = options.stateMap ?? coreHandle.stateMap;\n\n  // Create serve state\n  const serveState: ServeState = {\n    fetchHandler: null,\n    websocketHandlers: {},\n    pendingUpgrade: null,\n    activeConnections: new Map(),\n  };\n\n  // WebSocket command dispatcher\n  const wsCommandCallbacks = new Set<\n    (cmd: import(\"./types.mjs\").WebSocketCommand) => void\n  >();\n  const dispatchWsCommand = (cmd: import(\"./types.mjs\").WebSocketCommand) => {\n    for (const cb of wsCommandCallbacks) {\n      cb(cmd);\n    }\n  };\n\n  // Create stream factory for Request/Response body\n  const streamFactory = (source: UnderlyingSource) =>\n    createReadableStream(context, stateMap, source);\n\n  // Create stream helpers for upload streaming\n  const streamHelpers = {\n    createStream: streamFactory,\n    createEmptyStream: (): { instanceId: number; globalKey: string } => {\n      // Create a pure QuickJS ReadableStream with no source (no host callbacks)\n      // Store it on a unique global key so it can be retrieved from JS without\n      // returning a handle through the callback (which causes lifetime issues)\n      const globalKey = `__uploadStream_${Date.now()}_${Math.random().toString(36).slice(2)}__`;\n      const result = context.evalCode(`\n        (function() {\n          const stream = new ReadableStream();\n          globalThis[\"${globalKey}\"] = stream;\n          return stream.__instanceId__;\n        })()\n      `);\n      if (result.error) {\n        const error = context.dump(result.error);\n        result.error.dispose();\n        throw new Error(`Failed to create empty ReadableStream: ${JSON.stringify(error)}`);\n      }\n      const instanceId = context.getNumber(result.value);\n      result.value.dispose();\n\n      return { instanceId, globalKey };\n    },\n    pumpEventLoop: () => {\n      context.runtime.executePendingJobs();\n    },\n  };\n\n  // Create Headers class\n  const HeadersClass = createHeadersClass(context, stateMap);\n  context.setProp(context.global, \"Headers\", HeadersClass);\n  HeadersClass.dispose();\n\n  // Add Symbol.iterator support for Headers (for...of, Array.from, spread)\n  const iteratorResult = context.evalCode(`\n    Headers.prototype[Symbol.iterator] = function() {\n      return this.entries()[Symbol.iterator]();\n    };\n  `);\n  if (iteratorResult.error) {\n    iteratorResult.error.dispose();\n  } else {\n    iteratorResult.value.dispose();\n  }\n\n  // Create Request class\n  const RequestClass = createRequestClass(context, stateMap, streamHelpers);\n  context.setProp(context.global, \"Request\", RequestClass);\n  RequestClass.dispose();\n\n  // Wrap the body getter to resolve upload stream markers\n  // This works around the issue of returning QuickJSHandle from __hostCall__\n  const bodyGetterWrapperResult = context.evalCode(`\n    (function() {\n      const originalBodyDescriptor = Object.getOwnPropertyDescriptor(Request.prototype, 'body');\n      if (originalBodyDescriptor && originalBodyDescriptor.get) {\n        const originalGetter = originalBodyDescriptor.get;\n        Object.defineProperty(Request.prototype, 'body', {\n          get: function() {\n            const result = originalGetter.call(this);\n            // Check if result is an upload stream marker\n            if (typeof result === 'string' && result.startsWith('__UPLOAD_STREAM_KEY__:')) {\n              const globalKey = result.slice('__UPLOAD_STREAM_KEY__:'.length);\n              const stream = globalThis[globalKey];\n              // Don't delete the global - keep it around for subsequent calls\n              // The wrapper will cache this in _cachedBodyStream for future calls\n              return stream || null;\n            }\n            return result;\n          },\n          configurable: true,\n          enumerable: true\n        });\n      }\n    })();\n  `);\n  if (bodyGetterWrapperResult.error) {\n    console.error(\"Failed to wrap body getter:\", context.dump(bodyGetterWrapperResult.error));\n    bodyGetterWrapperResult.error.dispose();\n  } else {\n    bodyGetterWrapperResult.value.dispose();\n  }\n\n  // Create Response class\n  const ResponseClass = createResponseClass(context, stateMap, streamFactory);\n  context.setProp(context.global, \"Response\", ResponseClass);\n  ResponseClass.dispose();\n\n  // Add Response static methods (must be after Response and Headers are on global)\n  addResponseStaticMethods(context);\n\n  // Create AbortSignal and AbortController classes (pure QuickJS implementation)\n  setupAbortControllerAndSignal(context);\n\n  // Create FormData class\n  const FormDataClass = createFormDataClass(context, stateMap);\n  context.setProp(context.global, \"FormData\", FormDataClass);\n  FormDataClass.dispose();\n\n  // Add Symbol.iterator support for FormData (for...of, Array.from, spread)\n  const formDataIteratorResult = context.evalCode(`\n    FormData.prototype[Symbol.iterator] = function() {\n      return this.entries()[Symbol.iterator]();\n    };\n  `);\n  if (formDataIteratorResult.error) {\n    formDataIteratorResult.error.dispose();\n  } else {\n    formDataIteratorResult.value.dispose();\n  }\n\n  // Add Request.formData() method that returns a proper FormData instance\n  // Must be after both Request and FormData are on global\n  addRequestFormDataMethod(context);\n\n  // Add FormData.get()/getAll() overrides to reconstruct File instances\n  // Must be after both FormData and File are on global\n  addFormDataFileMethods(context);\n\n  // Create ServerWebSocket class (internal, for WebSocket handling)\n  const ServerWebSocketClass = createServerWebSocketClass(\n    context,\n    stateMap,\n    dispatchWsCommand\n  );\n  // Set on global with internal name so we can use evalCode to instantiate\n  context.setProp(context.global, \"__ServerWebSocket__\", ServerWebSocketClass);\n  ServerWebSocketClass.dispose();\n  // Note: ServerWebSocketClass handle is now owned by global\n\n  // Create Server class (internal, passed to fetch handler)\n  const ServerClass = createServerClass(context, stateMap, serveState);\n  // Set on global with internal name so we can use evalCode to instantiate\n  context.setProp(context.global, \"__Server__\", ServerClass);\n  ServerClass.dispose();\n  // Note: ServerClass handle is now owned by global\n\n  // Create fetch function\n  const fetchFn = createFetchFunction(context, options.onFetch);\n  context.setProp(context.global, \"fetch\", fetchFn);\n  fetchFn.dispose();\n\n  // Create serve function\n  const serveFn = createServeFunction(context, stateMap, serveState);\n  context.setProp(context.global, \"serve\", serveFn);\n  serveFn.dispose();\n\n  // Create and return the handle\n  const fetchHandle = createFetchHandle(\n    context,\n    stateMap,\n    serveState\n  );\n\n  // Wire up WebSocket command callbacks\n  const originalOnWebSocketCommand = fetchHandle.onWebSocketCommand;\n  fetchHandle.onWebSocketCommand = (callback) => {\n    wsCommandCallbacks.add(callback);\n    return () => wsCommandCallbacks.delete(callback);\n  };\n\n  return fetchHandle;\n}\n"
   ],
-  "mappings": ";;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAAA;AAAA;AAAA;AAKA;AA+CO,SAAS,UAAU,CACxB,SACA,UAA6B,CAAC,GACjB;AAAA,EAEb,MAAM,aACJ,QAAQ,cACR,UAAU,SAAS;AAAA,IACjB,UAAU,QAAQ;AAAA,EACpB,CAAC;AAAA,EAEH,MAAM,WAAW,QAAQ,YAAY,WAAW;AAAA,EAGhD,MAAM,aAAyB;AAAA,IAC7B,cAAc;AAAA,IACd,mBAAmB,CAAC;AAAA,IACpB,gBAAgB;AAAA,IAChB,mBAAmB,IAAI;AAAA,EACzB;AAAA,EAGA,MAAM,qBAAqB,IAAI;AAAA,EAG/B,MAAM,oBAAoB,CAAC,QAAgD;AAAA,IACzE,WAAW,MAAM,oBAAoB;AAAA,MACnC,GAAG,GAAG;AAAA,IACR;AAAA;AAAA,EAIF,MAAM,gBAAgB,CAAC,WACrB,qBAAqB,SAAS,UAAU,MAAM;AAAA,EAGhD,MAAM,eAAe,mBAAmB,SAAS,QAAQ;AAAA,EACzD,QAAQ,QAAQ,QAAQ,QAAQ,WAAW,YAAY;AAAA,EACvD,aAAa,QAAQ;AAAA,EAGrB,MAAM,iBAAiB,QAAQ,SAAS;AAAA;AAAA;AAAA;AAAA,GAIvC;AAAA,EACD,IAAI,eAAe,OAAO;AAAA,IACxB,eAAe,MAAM,QAAQ;AAAA,EAC/B,EAAO;AAAA,IACL,eAAe,MAAM,QAAQ;AAAA;AAAA,EAI/B,MAAM,eAAe,mBAAmB,SAAS,UAAU,aAAa;AAAA,EACxE,QAAQ,QAAQ,QAAQ,QAAQ,WAAW,YAAY;AAAA,EACvD,aAAa,QAAQ;AAAA,EAGrB,MAAM,gBAAgB,oBAAoB,SAAS,UAAU,aAAa;AAAA,EAC1E,QAAQ,QAAQ,QAAQ,QAAQ,YAAY,aAAa;AAAA,EACzD,cAAc,QAAQ;AAAA,EAGtB,yBAAyB,OAAO;AAAA,EAGhC,8BAA8B,OAAO;AAAA,EAGrC,MAAM,gBAAgB,oBAAoB,SAAS,QAAQ;AAAA,EAC3D,QAAQ,QAAQ,QAAQ,QAAQ,YAAY,aAAa;AAAA,EACzD,cAAc,QAAQ;AAAA,EAGtB,MAAM,yBAAyB,QAAQ,SAAS;AAAA;AAAA;AAAA;AAAA,GAI/C;AAAA,EACD,IAAI,uBAAuB,OAAO;AAAA,IAChC,uBAAuB,MAAM,QAAQ;AAAA,EACvC,EAAO;AAAA,IACL,uBAAuB,MAAM,QAAQ;AAAA;AAAA,EAKvC,yBAAyB,OAAO;AAAA,EAIhC,uBAAuB,OAAO;AAAA,EAG9B,MAAM,uBAAuB,2BAC3B,SACA,UACA,iBACF;AAAA,EAEA,QAAQ,QAAQ,QAAQ,QAAQ,uBAAuB,oBAAoB;AAAA,EAC3E,qBAAqB,QAAQ;AAAA,EAI7B,MAAM,cAAc,kBAAkB,SAAS,UAAU,UAAU;AAAA,EAEnE,QAAQ,QAAQ,QAAQ,QAAQ,cAAc,WAAW;AAAA,EACzD,YAAY,QAAQ;AAAA,EAIpB,MAAM,UAAU,oBAAoB,SAAS,QAAQ,OAAO;AAAA,EAC5D,QAAQ,QAAQ,QAAQ,QAAQ,SAAS,OAAO;AAAA,EAChD,QAAQ,QAAQ;AAAA,EAGhB,MAAM,UAAU,oBAAoB,SAAS,UAAU,UAAU;AAAA,EACjE,QAAQ,QAAQ,QAAQ,QAAQ,SAAS,OAAO;AAAA,EAChD,QAAQ,QAAQ;AAAA,EAGhB,MAAM,cAAc,kBAClB,SACA,UACA,UACF;AAAA,EAGA,MAAM,6BAA6B,YAAY;AAAA,EAC/C,YAAY,qBAAqB,CAAC,aAAa;AAAA,IAC7C,mBAAmB,IAAI,QAAQ;AAAA,IAC/B,OAAO,MAAM,mBAAmB,OAAO,QAAQ;AAAA;AAAA,EAGjD,OAAO;AAAA;",
-  "debugId": "E9661F932BB0303C64756E2164756E21",
+  "mappings": ";;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AAAA;AAAA;AAAA;AAAA;AAKA;AA+CO,SAAS,UAAU,CACxB,SACA,UAA6B,CAAC,GACjB;AAAA,EAEb,MAAM,aACJ,QAAQ,cACR,UAAU,SAAS;AAAA,IACjB,UAAU,QAAQ;AAAA,EACpB,CAAC;AAAA,EAEH,MAAM,WAAW,QAAQ,YAAY,WAAW;AAAA,EAGhD,MAAM,aAAyB;AAAA,IAC7B,cAAc;AAAA,IACd,mBAAmB,CAAC;AAAA,IACpB,gBAAgB;AAAA,IAChB,mBAAmB,IAAI;AAAA,EACzB;AAAA,EAGA,MAAM,qBAAqB,IAAI;AAAA,EAG/B,MAAM,oBAAoB,CAAC,QAAgD;AAAA,IACzE,WAAW,MAAM,oBAAoB;AAAA,MACnC,GAAG,GAAG;AAAA,IACR;AAAA;AAAA,EAIF,MAAM,gBAAgB,CAAC,WACrB,qBAAqB,SAAS,UAAU,MAAM;AAAA,EAGhD,MAAM,gBAAgB;AAAA,IACpB,cAAc;AAAA,IACd,mBAAmB,MAAiD;AAAA,MAIlE,MAAM,YAAY,kBAAkB,KAAK,IAAI,KAAK,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC;AAAA,MACpF,MAAM,SAAS,QAAQ,SAAS;AAAA;AAAA;AAAA,wBAGd;AAAA;AAAA;AAAA,OAGjB;AAAA,MACD,IAAI,OAAO,OAAO;AAAA,QAChB,MAAM,QAAQ,QAAQ,KAAK,OAAO,KAAK;AAAA,QACvC,OAAO,MAAM,QAAQ;AAAA,QACrB,MAAM,IAAI,MAAM,0CAA0C,KAAK,UAAU,KAAK,GAAG;AAAA,MACnF;AAAA,MACA,MAAM,aAAa,QAAQ,UAAU,OAAO,KAAK;AAAA,MACjD,OAAO,MAAM,QAAQ;AAAA,MAErB,OAAO,EAAE,YAAY,UAAU;AAAA;AAAA,IAEjC,eAAe,MAAM;AAAA,MACnB,QAAQ,QAAQ,mBAAmB;AAAA;AAAA,EAEvC;AAAA,EAGA,MAAM,eAAe,mBAAmB,SAAS,QAAQ;AAAA,EACzD,QAAQ,QAAQ,QAAQ,QAAQ,WAAW,YAAY;AAAA,EACvD,aAAa,QAAQ;AAAA,EAGrB,MAAM,iBAAiB,QAAQ,SAAS;AAAA;AAAA;AAAA;AAAA,GAIvC;AAAA,EACD,IAAI,eAAe,OAAO;AAAA,IACxB,eAAe,MAAM,QAAQ;AAAA,EAC/B,EAAO;AAAA,IACL,eAAe,MAAM,QAAQ;AAAA;AAAA,EAI/B,MAAM,eAAe,mBAAmB,SAAS,UAAU,aAAa;AAAA,EACxE,QAAQ,QAAQ,QAAQ,QAAQ,WAAW,YAAY;AAAA,EACvD,aAAa,QAAQ;AAAA,EAIrB,MAAM,0BAA0B,QAAQ,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAuBhD;AAAA,EACD,IAAI,wBAAwB,OAAO;AAAA,IACjC,QAAQ,MAAM,+BAA+B,QAAQ,KAAK,wBAAwB,KAAK,CAAC;AAAA,IACxF,wBAAwB,MAAM,QAAQ;AAAA,EACxC,EAAO;AAAA,IACL,wBAAwB,MAAM,QAAQ;AAAA;AAAA,EAIxC,MAAM,gBAAgB,oBAAoB,SAAS,UAAU,aAAa;AAAA,EAC1E,QAAQ,QAAQ,QAAQ,QAAQ,YAAY,aAAa;AAAA,EACzD,cAAc,QAAQ;AAAA,EAGtB,yBAAyB,OAAO;AAAA,EAGhC,8BAA8B,OAAO;AAAA,EAGrC,MAAM,gBAAgB,oBAAoB,SAAS,QAAQ;AAAA,EAC3D,QAAQ,QAAQ,QAAQ,QAAQ,YAAY,aAAa;AAAA,EACzD,cAAc,QAAQ;AAAA,EAGtB,MAAM,yBAAyB,QAAQ,SAAS;AAAA;AAAA;AAAA;AAAA,GAI/C;AAAA,EACD,IAAI,uBAAuB,OAAO;AAAA,IAChC,uBAAuB,MAAM,QAAQ;AAAA,EACvC,EAAO;AAAA,IACL,uBAAuB,MAAM,QAAQ;AAAA;AAAA,EAKvC,yBAAyB,OAAO;AAAA,EAIhC,uBAAuB,OAAO;AAAA,EAG9B,MAAM,uBAAuB,2BAC3B,SACA,UACA,iBACF;AAAA,EAEA,QAAQ,QAAQ,QAAQ,QAAQ,uBAAuB,oBAAoB;AAAA,EAC3E,qBAAqB,QAAQ;AAAA,EAI7B,MAAM,cAAc,kBAAkB,SAAS,UAAU,UAAU;AAAA,EAEnE,QAAQ,QAAQ,QAAQ,QAAQ,cAAc,WAAW;AAAA,EACzD,YAAY,QAAQ;AAAA,EAIpB,MAAM,UAAU,oBAAoB,SAAS,QAAQ,OAAO;AAAA,EAC5D,QAAQ,QAAQ,QAAQ,QAAQ,SAAS,OAAO;AAAA,EAChD,QAAQ,QAAQ;AAAA,EAGhB,MAAM,UAAU,oBAAoB,SAAS,UAAU,UAAU;AAAA,EACjE,QAAQ,QAAQ,QAAQ,QAAQ,SAAS,OAAO;AAAA,EAChD,QAAQ,QAAQ;AAAA,EAGhB,MAAM,cAAc,kBAClB,SACA,UACA,UACF;AAAA,EAGA,MAAM,6BAA6B,YAAY;AAAA,EAC/C,YAAY,qBAAqB,CAAC,aAAa;AAAA,IAC7C,mBAAmB,IAAI,QAAQ;AAAA,IAC/B,OAAO,MAAM,mBAAmB,OAAO,QAAQ;AAAA;AAAA,EAGjD,OAAO;AAAA;",
+  "debugId": "540F333C1CD9EF6B64756E2164756E21",
   "names": []
 }

package/dist/mjs/upload-stream-queue.mjs

@@ -0,0 +1,145 @@
+// @bun
+// packages/fetch/src/upload-stream-queue.ts
+import {
+  nextInstanceId,
+  registerInstance,
+  getInstanceStateById,
+  cleanupInstanceStateById
+} from "@ricsam/quickjs-core";
+var MAX_QUEUE_CHUNKS = 10;
+var CHUNK_SIZE = 64 * 1024;
+function createUploadQueue() {
+  const instanceId = nextInstanceId();
+  const queue = {
+    chunks: [],
+    closed: false,
+    error: undefined,
+    paused: false,
+    resumeCallback: undefined,
+    cancelCallback: undefined
+  };
+  registerInstance(instanceId, "UploadStreamQueue", queue);
+  return instanceId;
+}
+function getUploadQueue(instanceId) {
+  return getInstanceStateById(instanceId);
+}
+function cleanupUploadQueue(instanceId) {
+  cleanupInstanceStateById(instanceId);
+}
+function pushToQuickJSStream(streamInstanceId, chunk) {
+  const state = getInstanceStateById(streamInstanceId);
+  if (!state) {
+    return false;
+  }
+  if (state.closeRequested || state.closed || state.errored) {
+    return false;
+  }
+  state.queue.push(chunk);
+  if (state.reader && state.reader.readRequests.length > 0) {
+    const request = state.reader.readRequests.shift();
+    const value = state.queue.shift();
+    request.resolve({ value, done: false });
+  }
+  return true;
+}
+function closeQuickJSStream(streamInstanceId) {
+  const state = getInstanceStateById(streamInstanceId);
+  if (!state) {
+    return;
+  }
+  if (state.closeRequested || state.closed) {
+    return;
+  }
+  state.closeRequested = true;
+  if (state.queue.length === 0) {
+    state.closed = true;
+    if (state.reader) {
+      state.reader.closedPromiseResolvers.resolve();
+      for (const request of state.reader.readRequests) {
+        request.resolve({ value: undefined, done: true });
+      }
+      state.reader.readRequests = [];
+    }
+  }
+}
+function errorQuickJSStream(streamInstanceId, error) {
+  const state = getInstanceStateById(streamInstanceId);
+  if (!state) {
+    return;
+  }
+  if (state.errored || state.closed) {
+    return;
+  }
+  state.errored = true;
+  state.errorValue = { name: error.name, message: error.message };
+  if (state.reader) {
+    state.reader.closedPromiseResolvers.reject(state.errorValue);
+    for (const request of state.reader.readRequests) {
+      request.reject(state.errorValue);
+    }
+    state.reader.readRequests = [];
+  }
+}
+function isQuickJSStreamQueueFull(streamInstanceId) {
+  const state = getInstanceStateById(streamInstanceId);
+  if (!state) {
+    return true;
+  }
+  return state.queue.length >= MAX_QUEUE_CHUNKS;
+}
+function startNativeStreamReader(nativeStream, quickjsStreamInstanceId, onChunkPushed) {
+  const reader = nativeStream.getReader();
+  let cancelled = false;
+  (async () => {
+    try {
+      while (!cancelled) {
+        if (isQuickJSStreamQueueFull(quickjsStreamInstanceId)) {
+          await new Promise((resolve) => setTimeout(resolve, 1));
+          continue;
+        }
+        const { done, value } = await reader.read();
+        if (done) {
+          closeQuickJSStream(quickjsStreamInstanceId);
+          onChunkPushed?.();
+          break;
+        }
+        if (value) {
+          if (value.length > CHUNK_SIZE) {
+            let offset = 0;
+            while (offset < value.length) {
+              const chunk = value.slice(offset, offset + CHUNK_SIZE);
+              pushToQuickJSStream(quickjsStreamInstanceId, chunk);
+              offset += chunk.length;
+            }
+          } else {
+            pushToQuickJSStream(quickjsStreamInstanceId, value);
+          }
+          onChunkPushed?.();
+        }
+      }
+    } catch (error) {
+      if (!cancelled) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        errorQuickJSStream(quickjsStreamInstanceId, err);
+        onChunkPushed?.();
+      }
+    }
+  })();
+  return () => {
+    cancelled = true;
+    reader.cancel().catch(() => {});
+  };
+}
+export {
+  startNativeStreamReader,
+  pushToQuickJSStream,
+  isQuickJSStreamQueueFull,
+  getUploadQueue,
+  errorQuickJSStream,
+  createUploadQueue,
+  closeQuickJSStream,
+  cleanupUploadQueue
+};
+
+//# debugId=E26FBAE75EE5DFA264756E2164756E21

package/dist/mjs/upload-stream-queue.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/upload-stream-queue.ts"],
+  "sourcesContent": [
+    "/**\n * Upload stream queue management for bridging native ReadableStreams to QuickJS.\n *\n * This module implements the \"Inverted Direct State Access\" pattern:\n * - Native stream reader reads data and pushes directly to QuickJS stream's internal queue\n * - QuickJS stream's read() method reads from the queue\n * - No async callbacks with QuickJS handles, avoiding handle lifetime issues\n *\n * The pattern is the reverse of download streaming (handle.ts:createNativeStreamFromState):\n * - Download: QuickJS enqueues → host polls queue\n * - Upload: Host pushes to queue → QuickJS reads\n */\n\nimport type { UploadStreamQueue } from \"./types.mjs\";\nimport {\n  nextInstanceId,\n  registerInstance,\n  getInstanceStateById,\n  cleanupInstanceStateById,\n} from \"@ricsam/quickjs-core\";\n\n/** Maximum chunks to buffer before applying backpressure */\nconst MAX_QUEUE_CHUNKS = 10;\n/** Chunk size for reading from native stream (64KB, consistent with FS streaming) */\nconst CHUNK_SIZE = 64 * 1024;\n\n/**\n * Internal state of a QuickJS ReadableStream.\n * This mirrors the structure in core/streams/readable-stream.ts.\n */\ninterface ReadableStreamInternalState {\n  locked: boolean;\n  queue: unknown[];\n  closeRequested: boolean;\n  closed: boolean;\n  errored: boolean;\n  errorValue: unknown;\n  reader: ReadableStreamReaderState | null;\n}\n\ninterface ReadableStreamReaderState {\n  readRequests: Array<{\n    resolve: (result: { value: unknown; done: boolean }) => void;\n    reject: (e: unknown) => void;\n  }>;\n  closedPromiseResolvers: {\n    resolve: () => void;\n    reject: (e: unknown) => void;\n  };\n}\n\n/**\n * Create a new upload queue and register it in instance state.\n * Returns the instance ID for accessing the queue via getUploadQueue().\n */\nexport function createUploadQueue(): number {\n  const instanceId = nextInstanceId();\n  const queue: UploadStreamQueue = {\n    chunks: [],\n    closed: false,\n    error: undefined,\n    paused: false,\n    resumeCallback: undefined,\n    cancelCallback: undefined,\n  };\n\n  registerInstance(instanceId, \"UploadStreamQueue\", queue);\n  return instanceId;\n}\n\n/**\n * Get an upload queue by its instance ID.\n */\nexport function getUploadQueue(instanceId: number): UploadStreamQueue | undefined {\n  return getInstanceStateById<UploadStreamQueue>(instanceId);\n}\n\n/**\n * Clean up an upload queue when no longer needed.\n */\nexport function cleanupUploadQueue(instanceId: number): void {\n  cleanupInstanceStateById(instanceId);\n}\n\n/**\n * Push a chunk to a QuickJS ReadableStream's internal queue.\n * If there are pending read requests, fulfills the first one immediately.\n *\n * @param streamInstanceId The instance ID of the QuickJS ReadableStream\n * @param chunk The data chunk to enqueue\n * @returns true if the chunk was successfully enqueued\n */\nexport function pushToQuickJSStream(\n  streamInstanceId: number,\n  chunk: Uint8Array\n): boolean {\n  const state = getInstanceStateById<ReadableStreamInternalState>(streamInstanceId);\n  if (!state) {\n    return false;\n  }\n\n  if (state.closeRequested || state.closed || state.errored) {\n    return false;\n  }\n\n  // Push chunk to queue\n  state.queue.push(chunk);\n\n  // If there are pending read requests, fulfill the first one\n  if (state.reader && state.reader.readRequests.length > 0) {\n    const request = state.reader.readRequests.shift()!;\n    const value = state.queue.shift();\n    request.resolve({ value, done: false });\n  }\n\n  return true;\n}\n\n/**\n * Close a QuickJS ReadableStream.\n * If there are pending read requests, fulfills them with done: true.\n *\n * @param streamInstanceId The instance ID of the QuickJS ReadableStream\n */\nexport function closeQuickJSStream(streamInstanceId: number): void {\n  const state = getInstanceStateById<ReadableStreamInternalState>(streamInstanceId);\n  if (!state) {\n    return;\n  }\n\n  if (state.closeRequested || state.closed) {\n    return;\n  }\n\n  state.closeRequested = true;\n\n  if (state.queue.length === 0) {\n    state.closed = true;\n    if (state.reader) {\n      state.reader.closedPromiseResolvers.resolve();\n      // Resolve any pending reads with done: true\n      for (const request of state.reader.readRequests) {\n        request.resolve({ value: undefined, done: true });\n      }\n      state.reader.readRequests = [];\n    }\n  }\n}\n\n/**\n * Error a QuickJS ReadableStream.\n *\n * @param streamInstanceId The instance ID of the QuickJS ReadableStream\n * @param error The error to propagate\n */\nexport function errorQuickJSStream(streamInstanceId: number, error: Error): void {\n  const state = getInstanceStateById<ReadableStreamInternalState>(streamInstanceId);\n  if (!state) {\n    return;\n  }\n\n  if (state.errored || state.closed) {\n    return;\n  }\n\n  state.errored = true;\n  state.errorValue = { name: error.name, message: error.message };\n\n  if (state.reader) {\n    state.reader.closedPromiseResolvers.reject(state.errorValue);\n    for (const request of state.reader.readRequests) {\n      request.reject(state.errorValue);\n    }\n    state.reader.readRequests = [];\n  }\n}\n\n/**\n * Check if a QuickJS ReadableStream's queue is full (for backpressure).\n *\n * @param streamInstanceId The instance ID of the QuickJS ReadableStream\n * @returns true if the queue has reached capacity\n */\nexport function isQuickJSStreamQueueFull(streamInstanceId: number): boolean {\n  const state = getInstanceStateById<ReadableStreamInternalState>(streamInstanceId);\n  if (!state) {\n    return true; // Treat missing stream as full\n  }\n  return state.queue.length >= MAX_QUEUE_CHUNKS;\n}\n\n/**\n * Start a background reader that reads from a native ReadableStream\n * and pushes chunks directly to a QuickJS ReadableStream.\n *\n * The reader respects backpressure by pausing when the QuickJS queue is full\n * (10+ chunks) and resuming when QuickJS consumes chunks.\n *\n * @param nativeStream The native ReadableStream to read from\n * @param quickjsStreamInstanceId The instance ID of the QuickJS ReadableStream\n * @param onChunkPushed Optional callback called after each chunk is pushed\n * @returns A cleanup function to cancel the reader\n */\nexport function startNativeStreamReader(\n  nativeStream: ReadableStream<Uint8Array>,\n  quickjsStreamInstanceId: number,\n  onChunkPushed?: () => void\n): () => void {\n  const reader = nativeStream.getReader();\n  let cancelled = false;\n\n  // Start reading in background\n  (async () => {\n    try {\n      while (!cancelled) {\n        // Check for backpressure\n        if (isQuickJSStreamQueueFull(quickjsStreamInstanceId)) {\n          // Wait a bit for the queue to drain\n          await new Promise<void>((resolve) => setTimeout(resolve, 1));\n          continue;\n        }\n\n        const { done, value } = await reader.read();\n\n        if (done) {\n          closeQuickJSStream(quickjsStreamInstanceId);\n          onChunkPushed?.();\n          break;\n        }\n\n        if (value) {\n          // Split large chunks into CHUNK_SIZE pieces for consistent streaming\n          if (value.length > CHUNK_SIZE) {\n            let offset = 0;\n            while (offset < value.length) {\n              const chunk = value.slice(offset, offset + CHUNK_SIZE);\n              pushToQuickJSStream(quickjsStreamInstanceId, chunk);\n              offset += chunk.length;\n            }\n          } else {\n            pushToQuickJSStream(quickjsStreamInstanceId, value);\n          }\n          onChunkPushed?.();\n        }\n      }\n    } catch (error) {\n      if (!cancelled) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        errorQuickJSStream(quickjsStreamInstanceId, err);\n        onChunkPushed?.();\n      }\n    }\n  })();\n\n  // Return cleanup function\n  return () => {\n    cancelled = true;\n    reader.cancel().catch(() => {\n      // Ignore cancel errors\n    });\n  };\n}\n\n"
+  ],
+  "mappings": "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",
+  "debugId": "E26FBAE75EE5DFA264756E2164756E21",
+  "names": []
+}

package/dist/types/globals/request.d.ts

@@ -5,10 +5,22 @@ import type { RequestState } from "../types.ts";
  * Type for the stream factory function
  */
 type StreamFactory = (source: UnderlyingSource) => QuickJSHandle;
+/**
+ * Stream helpers passed to the body getter for upload streaming
+ */
+interface StreamHelpers {
+    createStream: StreamFactory;
+    /** Creates an empty ReadableStream, stores on global, returns instanceId and globalKey */
+    createEmptyStream: () => {
+        instanceId: number;
+        globalKey: string;
+    };
+    pumpEventLoop: () => void;
+}
 /**
  * Create the Request class for QuickJS
  */
-export declare function createRequestClass(context: QuickJSContext, stateMap: StateMap, createStream?: StreamFactory): QuickJSHandle;
+export declare function createRequestClass(context: QuickJSContext, stateMap: StateMap, streamHelpers?: StreamHelpers): QuickJSHandle;
 /**
  * Add the formData() method to Request.prototype via evalCode.
  *
@@ -19,7 +31,13 @@ export declare function createRequestClass(context: QuickJSContext, stateMap: St
  */
 export declare function addRequestFormDataMethod(context: QuickJSContext): void;
 /**
- * Create a RequestState from a native Request object
+ * Create a RequestState from a native Request object.
+ *
+ * This is now synchronous - we preserve the native ReadableStream instead of
+ * buffering it. The stream is consumed lazily when QuickJS code accesses
+ * request.body or calls request.text()/json()/arrayBuffer().
+ *
+ * This enables streaming large uploads (1GB+) without buffering.
  */
-export declare function createRequestStateFromNative(request: Request): Promise<RequestState>;
+export declare function createRequestStateFromNative(request: Request): RequestState;
 export {};

package/dist/types/types.d.ts

@@ -141,6 +141,8 @@ export interface RequestState {
     referrer: string;
     referrerPolicy: string;
     signal: AbortSignalState | null;
+    /** Native ReadableStream for streaming request bodies (upload streaming) */
+    nativeBodyStream?: ReadableStream<Uint8Array>;
 }
 export interface ResponseState {
     status: number;
@@ -153,7 +155,9 @@ export interface ResponseState {
     type: string;
     ok: boolean;
     /** Original body type - used to convert back to string for native Response */
-    bodyType?: "string" | "binary" | null;
+    bodyType?: "string" | "binary" | "stream" | null;
+    /** Instance ID of ReadableStream when bodyType is "stream" */
+    streamInstanceId?: number;
 }
 export interface AbortControllerState {
     signalState: AbortSignalState;
@@ -176,3 +180,23 @@ export interface FormDataEntry {
 export interface FormDataState {
     entries: FormDataEntry[];
 }
+/**
+ * Host-side queue for upload stream bridging.
+ * Native ReadableStream reader pushes chunks here.
+ * QuickJS ReadableStream's synchronous pull() reads from here.
+ * This avoids async callbacks with QuickJS handles.
+ */
+export interface UploadStreamQueue {
+    /** Buffered chunks waiting to be read by QuickJS */
+    chunks: Uint8Array[];
+    /** Whether the native stream has closed */
+    closed: boolean;
+    /** Error from native stream if any */
+    error?: Error;
+    /** Whether the native reader should pause (backpressure) */
+    paused: boolean;
+    /** Callback to resume native reader when queue is drained */
+    resumeCallback?: () => void;
+    /** Callback to cancel native reader when QuickJS stream is cancelled */
+    cancelCallback?: () => void;
+}

package/dist/types/upload-stream-queue.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Upload stream queue management for bridging native ReadableStreams to QuickJS.
+ *
+ * This module implements the "Inverted Direct State Access" pattern:
+ * - Native stream reader reads data and pushes directly to QuickJS stream's internal queue
+ * - QuickJS stream's read() method reads from the queue
+ * - No async callbacks with QuickJS handles, avoiding handle lifetime issues
+ *
+ * The pattern is the reverse of download streaming (handle.ts:createNativeStreamFromState):
+ * - Download: QuickJS enqueues → host polls queue
+ * - Upload: Host pushes to queue → QuickJS reads
+ */
+import type { UploadStreamQueue } from "./types.ts";
+/**
+ * Create a new upload queue and register it in instance state.
+ * Returns the instance ID for accessing the queue via getUploadQueue().
+ */
+export declare function createUploadQueue(): number;
+/**
+ * Get an upload queue by its instance ID.
+ */
+export declare function getUploadQueue(instanceId: number): UploadStreamQueue | undefined;
+/**
+ * Clean up an upload queue when no longer needed.
+ */
+export declare function cleanupUploadQueue(instanceId: number): void;
+/**
+ * Push a chunk to a QuickJS ReadableStream's internal queue.
+ * If there are pending read requests, fulfills the first one immediately.
+ *
+ * @param streamInstanceId The instance ID of the QuickJS ReadableStream
+ * @param chunk The data chunk to enqueue
+ * @returns true if the chunk was successfully enqueued
+ */
+export declare function pushToQuickJSStream(streamInstanceId: number, chunk: Uint8Array): boolean;
+/**
+ * Close a QuickJS ReadableStream.
+ * If there are pending read requests, fulfills them with done: true.
+ *
+ * @param streamInstanceId The instance ID of the QuickJS ReadableStream
+ */
+export declare function closeQuickJSStream(streamInstanceId: number): void;
+/**
+ * Error a QuickJS ReadableStream.
+ *
+ * @param streamInstanceId The instance ID of the QuickJS ReadableStream
+ * @param error The error to propagate
+ */
+export declare function errorQuickJSStream(streamInstanceId: number, error: Error): void;
+/**
+ * Check if a QuickJS ReadableStream's queue is full (for backpressure).
+ *
+ * @param streamInstanceId The instance ID of the QuickJS ReadableStream
+ * @returns true if the queue has reached capacity
+ */
+export declare function isQuickJSStreamQueueFull(streamInstanceId: number): boolean;
+/**
+ * Start a background reader that reads from a native ReadableStream
+ * and pushes chunks directly to a QuickJS ReadableStream.
+ *
+ * The reader respects backpressure by pausing when the QuickJS queue is full
+ * (10+ chunks) and resuming when QuickJS consumes chunks.
+ *
+ * @param nativeStream The native ReadableStream to read from
+ * @param quickjsStreamInstanceId The instance ID of the QuickJS ReadableStream
+ * @param onChunkPushed Optional callback called after each chunk is pushed
+ * @returns A cleanup function to cancel the reader
+ */
+export declare function startNativeStreamReader(nativeStream: ReadableStream<Uint8Array>, quickjsStreamInstanceId: number, onChunkPushed?: () => void): () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/quickjs-fetch",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {
@@ -16,7 +16,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ricsam/quickjs-core": "^0.2.6",
+    "@ricsam/quickjs-core": "^0.2.8",
     "quickjs-emscripten": "^0.31.0"
   },
   "peerDependencies": {