tabulark 0.1.0 → 0.2.1

package/dist/wasm/parquet/tabulark_parquet.js

@@ -91,6 +91,14 @@ function addHeapObject(obj) {
     return idx;
 }
 
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        wasm.__wbindgen_export_2(addHeapObject(e));
+    }
+}
+
 function dropObject(idx) {
     if (idx < 132) return;
     heap[idx] = heap_next;
@@ -103,14 +111,6 @@ function takeObject(idx) {
     return ret;
 }
 
-function handleError(f, args) {
-    try {
-        return f.apply(this, args);
-    } catch (e) {
-        wasm.__wbindgen_export_2(addHeapObject(e));
-    }
-}
-
 function isLikeNone(x) {
     return x === undefined || x === null;
 }
@@ -193,7 +193,7 @@ const WasmRuntimeFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_wasmruntime_free(ptr >>> 0, 1));
 /**
- * Official Parquet runtime implementing adapter ABI v2.
+ * Official Parquet runtime implementing adapter ABI v3.
  */
 export class WasmRuntime {
 
@@ -331,6 +331,49 @@ export class WasmRuntime {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Starts and completes an ABI-v3 metadata operation.
+     * @param {number} table_handle
+     * @returns {any}
+     */
+    beginMetadata(table_handle) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmruntime_beginMetadata(retptr, this.__wbg_ptr, table_handle);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Starts and completes an ABI-v3 open-table operation.
+     * @param {number} source_handle
+     * @param {string} table_id
+     * @returns {any}
+     */
+    beginOpenTable(source_handle, table_id) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(table_id, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.wasmruntime_beginOpenTable(retptr, this.__wbg_ptr, source_handle, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Cancels and releases one pending operation.
      * @param {number} operation_handle
@@ -341,7 +384,7 @@ export class WasmRuntime {
         return ret !== 0;
     }
     /**
-     * Returns Worker protocol version three.
+     * Returns Worker protocol version four.
      * @returns {number}
      */
     protocolVersion() {
@@ -349,17 +392,55 @@ export class WasmRuntime {
         return ret >>> 0;
     }
     /**
-     * Supplies one exact source range to an open or range-read operation.
+     * Returns the private adapter-owned resource ledger snapshot.
+     * @returns {any}
+     */
+    resourceSnapshot() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmruntime_resourceSnapshot(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Starts and completes an ABI-v3 static-presentation operation.
+     * @param {number} table_handle
+     * @returns {any}
+     */
+    beginPresentation(table_handle) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmruntime_beginPresentation(retptr, this.__wbg_ptr, table_handle);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Supplies one complete revision-matched source result set.
      * @param {number} operation_handle
-     * @param {number} absolute_offset
-     * @param {Uint8Array} bytes
-     * @param {boolean} eof
+     * @param {number} operation_revision
+     * @param {Array<any>} results
      * @returns {any}
      */
-    continueOperation(operation_handle, absolute_offset, bytes, eof) {
+    continueOperation(operation_handle, operation_revision, results) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.wasmruntime_continueOperation(retptr, this.__wbg_ptr, operation_handle, absolute_offset, addHeapObject(bytes), eof);
+            wasm.wasmruntime_continueOperation(retptr, this.__wbg_ptr, operation_handle, operation_revision, addHeapObject(results));
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -372,7 +453,7 @@ export class WasmRuntime {
         }
     }
     /**
-     * Returns official adapter ABI version two.
+     * Returns official adapter ABI version three.
      * @returns {number}
      */
     adapterApiVersion() {
@@ -408,6 +489,27 @@ export class WasmRuntime {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Starts and completes an ABI-v3 range-presentation operation.
+     * @param {number} table_handle
+     * @param {any} request
+     * @returns {any}
+     */
+    beginPresentationRange(table_handle, request) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmruntime_beginPresentationRange(retptr, this.__wbg_ptr, table_handle, addHeapObject(request));
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Creates an empty Parquet adapter runtime.
      * @param {any} config
@@ -502,6 +604,18 @@ function __wbg_get_imports() {
         const ret = getObject(arg0).buffer;
         return addHeapObject(ret);
     };
+    imports.wbg.__wbg_byteLength_ea52ac3de882b483 = function(arg0) {
+        const ret = getObject(arg0).byteLength;
+        return ret;
+    };
+    imports.wbg.__wbg_get_67b2ba62fc30de12 = function() { return handleError(function (arg0, arg1) {
+        const ret = Reflect.get(getObject(arg0), getObject(arg1));
+        return addHeapObject(ret);
+    }, arguments) };
+    imports.wbg.__wbg_get_b9b93047fe3cf45b = function(arg0, arg1) {
+        const ret = getObject(arg0)[arg1 >>> 0];
+        return addHeapObject(ret);
+    };
     imports.wbg.__wbg_getwithrefkey_1dc361bd10053bfe = function(arg0, arg1) {
         const ret = getObject(arg0)[getObject(arg1)];
         return addHeapObject(ret);
@@ -534,6 +648,10 @@ function __wbg_get_imports() {
         const ret = getObject(arg0).length;
         return ret;
     };
+    imports.wbg.__wbg_length_e2d2a49132c1b256 = function(arg0) {
+        const ret = getObject(arg0).length;
+        return ret;
+    };
     imports.wbg.__wbg_new_405e22f390576ce2 = function() {
         const ret = new Object();
         return addHeapObject(ret);

package/dist/wasm/parquet/tabulark_parquet_bg.wasm.d.ts

@@ -5,18 +5,23 @@ export const __wbg_wasmruntime_free: (a: number, b: number) => void;
 export const wasmruntime_adapterApiVersion: (a: number) => number;
 export const wasmruntime_adapterId: (a: number, b: number) => void;
 export const wasmruntime_batchLayoutVersion: (a: number) => number;
+export const wasmruntime_beginMetadata: (a: number, b: number, c: number) => void;
 export const wasmruntime_beginOpen: (a: number, b: number, c: number, d: number) => void;
+export const wasmruntime_beginOpenTable: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmruntime_beginPresentation: (a: number, b: number, c: number) => void;
+export const wasmruntime_beginPresentationRange: (a: number, b: number, c: number, d: number) => void;
 export const wasmruntime_beginRead: (a: number, b: number, c: number, d: number) => void;
 export const wasmruntime_cancelOperation: (a: number, b: number) => number;
 export const wasmruntime_closeSource: (a: number, b: number) => number;
 export const wasmruntime_closeTable: (a: number, b: number) => number;
-export const wasmruntime_continueOperation: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmruntime_continueOperation: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmruntime_metadata: (a: number, b: number, c: number) => void;
 export const wasmruntime_new: (a: number, b: number) => void;
 export const wasmruntime_openTable: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmruntime_presentation: (a: number, b: number, c: number) => void;
 export const wasmruntime_protocolVersion: (a: number) => number;
 export const wasmruntime_readPresentationRange: (a: number, b: number, c: number, d: number) => void;
+export const wasmruntime_resourceSnapshot: (a: number, b: number) => void;
 export const wasmruntime_shutdown: (a: number) => void;
 export const __wbindgen_export_0: (a: number, b: number) => number;
 export const __wbindgen_export_1: (a: number, b: number, c: number, d: number) => number;

package/dist/worker/blob-source-accessor.d.ts

@@ -0,0 +1,10 @@
+import type { SourceAccessor, SourceReadOptions } from "./source-accessor.js";
+/** Local Blob/File accessor kept in the eager Worker path. */
+export declare class BlobSourceAccessor implements SourceAccessor {
+    #private;
+    readonly kind: "blob";
+    readonly size: number;
+    constructor(blob: Blob);
+    read(offset: number, length: number, options?: SourceReadOptions): Promise<ArrayBuffer>;
+    close(): void;
+}

package/dist/worker/source-accessor.d.ts

@@ -0,0 +1,76 @@
+import { MAX_RANGE_SOURCE_BYTES } from "../range-source.js";
+/** The largest source address representable by the wasm32 adapter boundary. */
+export { MAX_RANGE_SOURCE_BYTES };
+/** A cancellation hook understood by the worker source broker. */
+export interface SourceReadOptions {
+    /** Resolves when the owning operation is cancelled. */
+    readonly cancellation?: Promise<void>;
+    /** Records one actual provider/Blob read after exact-length validation. */
+    readonly onProviderRead?: (bytes: number) => void;
+    /** Records bytes served without another provider read. */
+    readonly onCacheHit?: (bytes: number) => void;
+    /** Internal lifetime hook fired when the underlying read settles. */
+    readonly onSettled?: () => void;
+}
+export interface SourceAccessor {
+    readonly kind: "blob" | "range";
+    readonly size: number;
+    read(offset: number, length: number, options?: SourceReadOptions): Promise<ArrayBuffer>;
+    readMany?(requests: readonly Readonly<{
+        readonly offset: number;
+        readonly end: number;
+    }>[], options?: SourceReadOptions): Promise<readonly ArrayBuffer[]>;
+    /** Releases provider state and all retained range bytes. Idempotent. */
+    close(): void;
+}
+interface BrokerSourceDescriptor {
+    readonly kind: "range";
+    readonly handle: string;
+    readonly size: number;
+    readonly maxConcurrency?: number;
+}
+interface ReadInterval {
+    readonly offset: number;
+    readonly end: number;
+}
+/**
+ * The host-side half of the private Worker source broker.
+ *
+ * The host never gives callbacks to the Worker. It receives a small request
+ * DTO and sends back one transferable buffer, which keeps network/fetch state
+ * and credentials entirely on the main thread.
+ */
+export declare class WorkerSourceBroker {
+    #private;
+    constructor(scope: DedicatedWorkerGlobalScope);
+    request(sourceHandle: string, offset: number, length: number, options?: SourceReadOptions): Promise<ArrayBuffer>;
+    /** Handles a message delivered from the main-thread broker. */
+    handle(value: unknown): boolean;
+    close(sourceHandle: string): void;
+    shutdown(): void;
+}
+/** A local Blob/File accessor. Blob.slice remains the only source operation. */
+export declare class BlobSourceAccessor implements SourceAccessor {
+    #private;
+    readonly kind: "blob";
+    readonly size: number;
+    constructor(blob: Blob);
+    read(offset: number, length: number, options?: SourceReadOptions): Promise<ArrayBuffer>;
+    close(): void;
+}
+/**
+ * A remote range accessor. The interval cache is deliberately scoped to this
+ * accessor, which is one reader/dataset, so closing the dataset drops all
+ * retained bytes and pending singleflight state.
+ */
+export declare class RangeSourceAccessor implements SourceAccessor {
+    #private;
+    readonly kind: "range";
+    readonly size: number;
+    constructor(descriptor: BrokerSourceDescriptor, broker: WorkerSourceBroker, maxCacheBytes: number, maxReadBytes: number);
+    read(offset: number, length: number, options?: SourceReadOptions): Promise<ArrayBuffer>;
+    /** Reads a step's actions after merging overlaps and direct adjacency. */
+    readMany(requests: readonly ReadInterval[], options?: SourceReadOptions): Promise<readonly ArrayBuffer[]>;
+    close(): void;
+}
+export declare function validateRangeDescriptor(value: unknown): asserts value is BrokerSourceDescriptor;

package/dist/worker/wasm-adapter.d.ts

@@ -1,57 +1,58 @@
 import type { OfficialAdapterId } from "../adapters.js";
-interface AdapterPendingRead {
-    readonly operationHandle: string | number;
-    readonly action: Readonly<{
-        readonly kind: "read-bytes";
-        readonly offset: number;
-        readonly length: number;
-    }>;
+/** Private runtime seam shared by the compiled adapters. */
+export interface AdapterRuntime {
+    beginOpen(options: unknown, sourceLength: number): unknown | Promise<unknown>;
+    beginOpenTable(sourceHandle: string | number, tableId: string): unknown | Promise<unknown>;
+    beginMetadata(tableHandle: string | number): unknown | Promise<unknown>;
+    beginPresentation(tableHandle: string | number): unknown | Promise<unknown>;
+    beginPresentationRange(tableHandle: string | number, request: unknown): unknown | Promise<unknown>;
+    continueOperation(operationHandle: string | number, operationRevision: number, results: readonly AdapterActionResult[]): unknown | Promise<unknown>;
+    beginRead(tableHandle: string | number, request: unknown): unknown | Promise<unknown>;
+    cancelOperation(operationHandle: string | number): unknown;
+    closeTable(tableHandle: string | number): unknown;
+    closeSource(sourceHandle: string | number): unknown;
+    shutdown(): unknown;
+    dispose?(): void;
 }
-export interface AdapterReadBytesStep extends AdapterPendingRead {
+export interface AdapterReadAction {
     readonly kind: "read-bytes";
+    readonly actionIndex: number;
+    readonly offset: number;
+    readonly length: number;
 }
-export interface AdapterOpenProgressStep extends AdapterPendingRead {
-    readonly kind: "open-progress";
-    readonly sourceHandle: string | number;
-    readonly tables: unknown;
-    readonly metadata: unknown;
-    readonly progress: unknown;
-    readonly warnings?: unknown;
-}
-export interface AdapterOpenCompleteStep {
-    readonly kind: "open-complete";
-    readonly sourceHandle: string | number;
-    readonly tables: unknown;
-    readonly metadata: unknown;
-    readonly progress?: unknown;
-    readonly warnings?: unknown;
+export interface AdapterActionResult {
+    readonly actionIndex: number;
+    readonly offset: number;
+    readonly bytes: Uint8Array;
+    readonly eof: boolean;
 }
-export interface AdapterReadCompleteStep {
-    readonly kind: "read-complete";
-    readonly batch: unknown;
+export interface AdapterOperationStep {
+    readonly kind: "pending" | "progress" | "complete";
+    readonly operationHandle: string | number;
+    readonly operationRevision: number;
+    readonly actions: readonly AdapterReadAction[];
+    readonly cooperativeYield: boolean;
+    readonly payload?: unknown;
 }
-export type AdapterOpenStep = AdapterReadBytesStep | AdapterOpenProgressStep | AdapterOpenCompleteStep;
-export type AdapterReadStep = AdapterReadBytesStep | AdapterReadCompleteStep;
-export type AdapterOperationStep = AdapterOpenStep | AdapterReadStep;
 /**
  * The sole translation layer between the Worker protocol and wasm-bindgen.
  * Bulk arrays are copied by the Worker before they are transferred, never by
  * this adapter, so the runtime may safely return views into WebAssembly memory.
  */
-export declare class WasmAdapter {
+export declare class WasmAdapter implements AdapterRuntime {
     #private;
     private constructor();
     static load(moduleUrl: string, expectedAdapterId: OfficialAdapterId, config: unknown): Promise<WasmAdapter>;
-    metadata(sourceHandle: string | number): unknown;
-    presentation(tableHandle: string | number): unknown;
-    readPresentationRange(tableHandle: string | number, request: unknown): unknown;
-    beginOpen(options: unknown, sourceLength: number): AdapterOpenStep;
-    continueOperation(operationHandle: string | number, absoluteOffset: number, bytes: Uint8Array, eof: boolean): AdapterOperationStep;
-    openTable(sourceHandle: string | number, tableId: string): unknown;
-    beginRead(tableHandle: string | number, request: unknown): AdapterReadStep;
+    beginOpen(options: unknown, sourceLength: number): AdapterOperationStep | Promise<AdapterOperationStep>;
+    beginOpenTable(sourceHandle: string | number, tableId: string): AdapterOperationStep | Promise<AdapterOperationStep>;
+    beginMetadata(tableHandle: string | number): AdapterOperationStep | Promise<AdapterOperationStep>;
+    beginPresentation(tableHandle: string | number): AdapterOperationStep | Promise<AdapterOperationStep>;
+    beginPresentationRange(tableHandle: string | number, request: unknown): AdapterOperationStep | Promise<AdapterOperationStep>;
+    continueOperation(operationHandle: string | number, operationRevision: number, results: readonly AdapterActionResult[]): AdapterOperationStep | Promise<AdapterOperationStep>;
+    beginRead(tableHandle: string | number, request: unknown): AdapterOperationStep | Promise<AdapterOperationStep>;
     cancelOperation(operationHandle: string | number): void;
     closeTable(tableHandle: string | number): void;
     closeSource(sourceHandle: string | number): void;
+    shutdown(): void;
     dispose(): void;
 }
-export {};

package/dist/worker-range-source.d.ts

@@ -0,0 +1 @@
+export { RangeSourceAccessor, WorkerSourceBroker, validateRangeDescriptor, } from "./worker/source-accessor.js";

package/dist/worker-range-source.js

@@ -0,0 +1,2 @@
+function I(n){let e=S(n)?n:{},r=typeof e.resource=="string"&&e.resource.length>0?e.resource:typeof e.resourceCategory=="string"&&e.resourceCategory.length>0?e.resourceCategory:B(e);if(g(e.requiredBytes)&&g(e.availableBytes))return Object.freeze({...e,resource:r});if(g(e.required)&&g(e.available))return Object.freeze({...e,resource:r});let s=w(e,["maxDecodedBytes","maxOutputBytes","maxMetadataBytes","maxBlockBytes","maxDisplayCellBytes","maxDisplayBytes","maxSourceBytes","maxFieldBytes","maxBatchBytes","maxOperationBytes","maxZipEntryBytes","maxZipUncompressedBytes","maxCfbStreamBytes"]);if(s!==void 0){let i=w(e,["decodedBytes","outputBytes","metadataBytes","blockBytes","displayCellBytes","displayBytes","sourceBytes","fieldBytes","batchBytes","operationBytes"])??s+1;return Object.freeze({...e,resource:r,requiredBytes:i,availableBytes:s})}let o=w(e,["limit","maxCells","maxRangeCells","maxSources","maxActiveRanges","maxRangeWaiters","maxColumns","maxFields","maxNestingDepth","maxWorksheetRows","maxWorksheetColumns","maxStyles","maxMergedRegions"])??0,a=w(e,["cells","cellCount","visibleCellCount","sources","activeRanges","rangeWaiters","columns","fields","nestingDepth","worksheetRows","worksheetColumns","styles","mergedRegions"])??o+1;return Object.freeze({...e,resource:r,required:a,available:o})}function B(n){let e=Object.keys(n).join(" ").toLowerCase();return e.includes("source")?e.includes("byte")?"source-staging":"source-slots":e.includes("metadata")?"metadata":e.includes("decoded")||e.includes("decompress")?"decompression":e.includes("display")?"display-values":e.includes("field")?"field":e.includes("batch")?"batch":e.includes("range")||e.includes("cell")?"range-cells":e.includes("column")?"columns":e.includes("nest")?"descriptor-nesting":e.includes("worksheet")?"worksheet-dimensions":"adapter-resource"}function w(n,e){for(let r of e)if(g(n[r]))return n[r]}function g(n){return typeof n=="number"&&Number.isFinite(n)&&n>=0}function S(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}var c=class extends Error{code;retryable;details;constructor(e,r,s=!1,o,a){super(r,{cause:a}),this.name="ProtocolFault",this.code=e,this.retryable=s,this.details=e==="RESOURCE_LIMIT"?I(o):o}};var R=class{#s;#e=new Map;#i=1;#n=!1;constructor(e){this.#s=e}request(e,r,s,o={}){if(typeof e!="string"||e.length===0||!Number.isSafeInteger(r)||r<0||!Number.isSafeInteger(s)||s<0||r>4294967295||s>4294967295||r+s>4294967295)return Promise.reject(new c("RANGE_UNSUPPORTED","The source range is invalid"));if(this.#n)return Promise.reject(new c("HANDLE_CLOSED","The source broker is closed"));let a=`s${this.#i++}`;return new Promise((i,t)=>{let u={requestId:a,sourceHandle:e,offset:r,length:s,resolve:i,reject:t};this.#e.set(a,u);let f=!1,d=()=>{f||this.#e.get(a)!==u||(f=!0,this.#e.delete(a),this.#t(a,e),t(new c("CANCELLED","The source read was cancelled")))};o.cancellation&&o.cancellation.then(d,d);try{let l={type:"source-read",requestId:a,sourceHandle:e,offset:r,length:s};this.#s.postMessage(l)}catch(l){this.#e.delete(a),t(new c("SOURCE_UNAVAILABLE","The source provider could not receive a range request",!0,void 0,l))}})}handle(e){if(!E(e)||e.type!=="source-read-result"&&e.type!=="source-read-failure"&&e.type!=="source-read-error")return!1;if(typeof e.requestId!="string")return!0;let r=this.#e.get(e.requestId);if(!r)return!0;if(this.#e.delete(e.requestId),e.sourceHandle!==r.sourceHandle||e.offset!==r.offset||e.length!==r.length)return this.#t(r.requestId,r.sourceHandle),r.reject(new c("PROTOCOL_INCOMPATIBLE","The source provider returned a range for another request")),!0;if(e.type!=="source-read-result"||e.error!==void 0||e.ok===!1)return r.reject(P(e.error)),!0;try{r.resolve(_(e.buffer,r.length))}catch(s){r.reject(s instanceof c?s:new c("RUNTIME_FAILURE","The source provider returned invalid bytes",!1,void 0,s))}return!0}close(e){for(let[r,s]of this.#e)s.sourceHandle===e&&(this.#e.delete(r),this.#t(r,e),s.reject(new c("HANDLE_CLOSED","The source was closed")));if(!this.#n)try{this.#s.postMessage({type:"source-close",sourceHandle:e})}catch{}}shutdown(){if(!this.#n){this.#n=!0;for(let e of this.#e.values())this.#t(e.requestId,e.sourceHandle),e.reject(new c("HANDLE_CLOSED","The source broker was shut down"));this.#e.clear()}}#t(e,r){try{this.#s.postMessage({type:"source-read-cancel",requestId:e,sourceHandle:r})}catch{}}};var p=class{kind="range";size;#s;#e;#i;#n;#t;#r=[];#a=[];#c=[];#u=0;#f=0;#l=0;#o=!1;constructor(e,r,s,o){U(e),this.size=e.size,this.#e=e.handle,this.#s=r,this.#t=e.maxConcurrency===void 0?1:e.maxConcurrency,this.#i=Number.isSafeInteger(s)&&s>0?s:0,this.#n=Number.isSafeInteger(o)&&o>0?o:1}async read(e,r,s={}){try{return await this.#h(e,r,s)}finally{s.onSettled?.()}}async#h(e,r,s={}){let o=L(e,r,this.size);if(o===void 0)throw new c("RANGE_UNSUPPORTED","The requested source range is outside the source");if(this.#o)throw new c("HANDLE_CLOSED","The source is closed");if(r===0)return new ArrayBuffer(0);let a=this.#p(e,o),i=()=>{a>0&&s.onCacheHit?.(a),a=0};if(r>this.#n){let u=[],f=e;for(;f<o;){let h=Math.min(o,f+this.#n);u.push(await this.#h(f,h-f,s)),f=h}let d=new Uint8Array(r),l=0;for(let h of u)d.set(new Uint8Array(h),l),l+=h.byteLength;return d.buffer}let t=[];for(;;){if(this.#o)throw new c("HANDLE_CLOSED","The source is closed");let u=this.#d(e,o,t);if(u)return i(),u;let f=this.#a.filter(y=>y.waiters>0&&y.offset<o&&y.end>e);if(f.length>0){for(let m of f)m.waiters+=1;let y=[];try{y=await N(Promise.all(f.map(m=>m.promise)),s.cancellation)}finally{for(let m of f)this.#g(m)}t.push(...y);let C=this.#d(e,o,t);if(C!==void 0)return i(),C;continue}i();let d={offset:e,end:o,promise:Promise.resolve({offset:e,end:o,bytes:new ArrayBuffer(0)}),cancellation:x(),waiters:1,settled:!1},l=this.#E(e,o,d.cancellation.promise,s.onProviderRead,t);d.promise=l,this.#a.push(d),l.then(y=>{d.coverage=y,this.#m(d)},()=>this.#m(d));let h;try{h=await N(l,s.cancellation)}finally{this.#g(d)}return h.bytes}}async readMany(e,r={}){if(e.length===0)return Object.freeze([]);let s=e.map(i=>{let t=L(i.offset,i.end-i.offset,this.size);if(t===void 0)throw new c("RANGE_UNSUPPORTED","The requested source range is outside the source");return{offset:i.offset,end:t}}),o=O(s).flatMap(i=>D(i,this.#n)),a=[];return await T(o,this.#t,async i=>{let t=await this.read(i.offset,i.end-i.offset,r);a.push({offset:i.offset,end:i.end,bytes:t})}),Object.freeze(s.map(i=>{if(i.offset===i.end)return new ArrayBuffer(0);let t=this.#d(i.offset,i.end,a);if(!t)throw new c("SOURCE_UNAVAILABLE","The source provider returned no bytes",!0);return t}))}close(){if(!this.#o){this.#o=!0,this.#r.length=0,this.#f=0;for(let e of this.#a)e.waiters=0,e.cancellation.resolve();this.#a.length=0;for(let e of this.#c.splice(0))e.cancelled=!0,e.reject(new c("HANDLE_CLOSED","The source is closed"));this.#s.close(this.#e)}}async#w(e){if(this.#o)throw new c("HANDLE_CLOSED","The source is closed");return this.#u<this.#t?(this.#u+=1,()=>this.#y()):new Promise((r,s)=>{let o={resolve:r,reject:s,cancellation:e,cancelled:!1,granted:!1},a=()=>{if(o.cancelled||o.granted)return;o.cancelled=!0;let i=this.#c.indexOf(o);i>=0&&this.#c.splice(i,1),s(new c("CANCELLED","The source read was cancelled"))};e.then(a,a),this.#c.push(o)})}#y(){for(this.#u=Math.max(0,this.#u-1);this.#c.length>0;){let e=this.#c.shift();if(!e.cancelled){if(this.#o){e.cancelled=!0,e.reject(new c("HANDLE_CLOSED","The source is closed"));continue}this.#u+=1,e.granted=!0,e.resolve(()=>this.#y());return}}}async#E(e,r,s,o,a=[]){let i=this.#R(e,r,a),t=[];await T(i,this.#t,async d=>{let l=await this.#w(s),h;try{h=await this.#s.request(this.#e,d.offset,d.end-d.offset,{cancellation:s})}finally{l()}if(o?.(h.byteLength),this.#o)throw new c("HANDLE_CLOSED","The source is closed");t.push({offset:d.offset,end:d.end,bytes:h}),this.#A(d.offset,h)});let f=(a.length===0&&t.length===1&&t[0].offset===e&&t[0].end===r?t[0].bytes:void 0)??this.#d(e,r,[...a,...t]);if(f===void 0)throw new c("SOURCE_UNAVAILABLE","The source provider returned no bytes",!0);return{offset:e,end:r,bytes:f}}#R(e,r,s=[]){let o=this.#r.filter(t=>t.end>e&&t.offset<r).map(t=>({offset:Math.max(e,t.offset),end:Math.min(r,t.end)})).concat(s.filter(t=>t.end>e&&t.offset<r).map(t=>({offset:Math.max(e,t.offset),end:Math.min(r,t.end)}))).sort((t,u)=>t.offset-u.offset||t.end-u.end),a=[],i=e;for(let t of o)if(!(t.end<=i)&&(t.offset>i&&a.push({offset:i,end:t.offset}),i=Math.max(i,t.end),i>=r))break;return i<r&&a.push({offset:i,end:r}),a}#I(e,r){return this.#d(e,r,[])}#d(e,r,s){if(r===e)return new ArrayBuffer(0);let o=[];for(let t of this.#r)t.end<=e||t.offset>=r||(t.lastUsed=++this.#l,o.push({offset:t.offset,end:t.end,bytes:t.bytes}));for(let t of s)t.end>e&&t.offset<r&&o.push(t);o.sort((t,u)=>t.offset-u.offset||t.end-u.end);let a=new Uint8Array(r-e),i=e;for(let t of o){if(t.end<=i)continue;if(t.offset>i)return;let u=Math.max(i,t.offset),f=Math.min(r,t.end),d=u-t.offset,l=f-u;if(a.set(new Uint8Array(t.bytes,d,l),u-e),i=f,i>=r)break}return i>=r?a.buffer:void 0}#p(e,r,s=[]){let o=this.#r.filter(t=>t.end>e&&t.offset<r).map(t=>({offset:Math.max(e,t.offset),end:Math.min(r,t.end)})).concat(s.filter(t=>t.end>e&&t.offset<r).map(t=>({offset:Math.max(e,t.offset),end:Math.min(r,t.end)}))).sort((t,u)=>t.offset-u.offset||t.end-u.end),a=0,i=e;for(let t of o){let u=Math.max(i,t.offset);if(!(t.end<=u)&&(a+=t.end-u,i=t.end,i>=r))break}return a}#A(e,r){let s=r.byteLength;if(s===0||this.#i<=0||s>this.#i)return;let o=e+s,a={offset:e,end:o,bytes:r,lastUsed:++this.#l};for(this.#r.push(a),this.#f+=a.bytes.byteLength;this.#f>this.#i&&this.#r.length>0;){let i=this.#r[0];for(let t of this.#r)t.lastUsed<i.lastUsed&&(i=t);this.#C(i)}}#C(e){let r=this.#r.indexOf(e);r<0||(this.#r.splice(r,1),this.#f-=e.bytes.byteLength)}#m(e){e.settled=!0,e.waiters===0&&this.#b(e)}#g(e){e.waiters>0&&(e.waiters-=1),e.waiters===0&&!e.settled?e.cancellation.resolve():e.waiters===0&&this.#b(e)}#b(e){let r=this.#a.indexOf(e);r>=0&&this.#a.splice(r,1)}};function U(n){if(!E(n)||n.kind!=="range")throw new c("INVALID_ARGUMENT","source must be a range descriptor");if(Object.keys(n).some(s=>s!=="kind"&&s!=="handle"&&s!=="size"&&s!=="maxConcurrency"))throw new c("INVALID_ARGUMENT","range source descriptor contains private fields");let e=n.handle,r=n.size;if(typeof e!="string"||e.length===0||e.length>256)throw new c("INVALID_ARGUMENT","range source handle must be a non-empty string");if(!Number.isSafeInteger(r)||r<0||r>4294967295)throw new c("RESOURCE_LIMIT",`Range sources support at most ${4294967295} bytes`,!1,{resource:"source-staging",requiredBytes:A(r),availableBytes:4294967295});if(n.maxConcurrency!==void 0&&(!Number.isSafeInteger(n.maxConcurrency)||n.maxConcurrency<1||n.maxConcurrency>4))throw new c("INVALID_ARGUMENT","range source maxConcurrency must be between 1 and 4")}function P(n){if(E(n)&&typeof n.code=="string"){let e=n.code==="SOURCE_CHANGED"||n.code==="SOURCE_UNAVAILABLE"||n.code==="RANGE_UNSUPPORTED"||n.code==="RUNTIME_FAILURE"||n.code==="RESOURCE_LIMIT"||n.code==="CANCELLED"||n.code==="HANDLE_CLOSED"?n.code:"SOURCE_UNAVAILABLE",r=k(e);return new c(e,r,n.retryable===!0,e==="RESOURCE_LIMIT"?v(n.details):void 0)}return new c("SOURCE_UNAVAILABLE","The source provider failed to read bytes",!0)}function k(n){switch(n){case"SOURCE_CHANGED":return"The source changed while it was open";case"RANGE_UNSUPPORTED":return"The source does not support the requested byte range";case"RUNTIME_FAILURE":return"The source provider returned invalid bytes";case"RESOURCE_LIMIT":return"The source exceeds its configured limit";case"HANDLE_CLOSED":return"The source is closed";case"CANCELLED":return"The source read was cancelled";default:return"The source provider is unavailable"}}function v(n){return E(n)?{resource:typeof n.resource=="string"&&/^[A-Za-z0-9_.:-]{1,64}$/u.test(n.resource)?n.resource:"source-staging",requiredBytes:A(n.requiredBytes),availableBytes:A(n.availableBytes)}:{resource:"source-staging",requiredBytes:0,availableBytes:0}}function _(n,e){if(n instanceof ArrayBuffer){if(n.byteLength!==e)throw new c("RUNTIME_FAILURE","The source provider returned an invalid byte length");return n}if(ArrayBuffer.isView(n)){if(n.byteLength!==e)throw new c("RUNTIME_FAILURE","The source provider returned an invalid byte length");let r=new Uint8Array(e);return r.set(new Uint8Array(n.buffer,n.byteOffset,n.byteLength)),r.buffer}throw new c("RUNTIME_FAILURE","The source provider returned no byte buffer")}function L(n,e,r){if(!(!Number.isSafeInteger(n)||!Number.isSafeInteger(e)||n<0||e<0||!Number.isSafeInteger(r)||r<0||n>r||e>r-n))return n+e}function O(n){let e=[...n].sort((s,o)=>s.offset-o.offset||s.end-o.end),r=[];for(let s of e){let o=r[r.length-1];o&&s.offset<=o.end?s.end>o.end&&(r[r.length-1]={offset:o.offset,end:s.end}):r.push({...s})}return r}function D(n,e){if(n.end<=n.offset)return[{...n}];let r=[],s=n.offset;for(;s<n.end;){let o=Math.min(n.end,s+e);r.push({offset:s,end:o}),s=o}return r}async function T(n,e,r){let s=0,o,a=!1,i=async()=>{for(;;){if(a)return;let t=s++;if(t>=n.length)return;try{await r(n[t])}catch(u){a||(o=u,a=!0)}}};if(await Promise.all(Array.from({length:Math.min(e,n.length)},i)),a)throw o}function N(n,e){return e?Promise.race([n,e.then(()=>{throw new c("CANCELLED","The source read was cancelled")})]):n}function x(){let n;return{promise:new Promise(r=>{n=r}),resolve:n}}function A(n){return typeof n=="number"&&Number.isFinite(n)&&n>=0?Math.min(Math.floor(n),Number.MAX_SAFE_INTEGER):Number.MAX_SAFE_INTEGER}function E(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}export{p as RangeSourceAccessor,R as WorkerSourceBroker,U as validateRangeDescriptor};
+//# sourceMappingURL=worker-range-source.js.map