@ricsam/quickjs-fetch 0.2.8 → 0.2.10

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.8",
+  "version": "0.2.10",
   "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.7",
+    "@ricsam/quickjs-core": "^0.2.9",
     "quickjs-emscripten": "^0.31.0"
   },
   "peerDependencies": {