@loaders.gl/core 5.0.0-alpha.12 → 5.0.0-alpha.13

package/dist/loader-utils/lib/request-utils/authentication.js

@@ -0,0 +1,67 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Instantiates declarations without recreating credentials already supplied by the caller. */
+export function resolveCredentials(credentials, authentications = []) {
+    if (credentials.every(isAuthentication))
+        return credentials;
+    return credentials.map((credential, index) => {
+        if (isAuthentication(credential))
+            return credential;
+        const AuthenticationClass = authentications.find(authentication => authentication.type === credential?.type);
+        if (!AuthenticationClass) {
+            throw new Error(`No authentication class registered for credential at index ${index}.`);
+        }
+        let authentication;
+        try {
+            authentication = new AuthenticationClass(credential);
+        }
+        catch {
+            // Constructor messages may include credential configuration or secret material.
+            throw new Error(`Invalid authentication configuration at index ${index}.`);
+        }
+        if (!isAuthentication(authentication)) {
+            throw new Error(`Authentication class returned an invalid credential at index ${index}.`);
+        }
+        return authentication;
+    });
+}
+/** Resolves credentials while preserving the remaining loader options and caller-owned arrays. */
+export function resolveAuthenticationOptions(options) {
+    if (!options.core?.credentials?.length)
+        return options;
+    const credentials = resolveCredentials(options.core.credentials, options.core.authentications);
+    if (credentials === options.core.credentials)
+        return options;
+    return { ...options, core: { ...options.core, credentials } };
+}
+/** Discovers loader constructors before resolving declarative credentials for a load. */
+export async function resolveLoaderAuthenticationOptions(loader, url, options) {
+    if (!options.core?.credentials?.length || options.core.credentials.every(isAuthentication)) {
+        return options;
+    }
+    const contributions = await loader?.getAuthentications?.(url, options);
+    if (!contributions?.length)
+        return resolveAuthenticationOptions(options);
+    return resolveAuthenticationOptions({
+        ...options,
+        core: {
+            ...options.core,
+            authentications: [...(options.core?.authentications || []), ...contributions]
+        }
+    });
+}
+/** Tests the public runtime credential shape without relying on class identity. */
+function isAuthentication(credential) {
+    if (!credential || typeof credential !== 'object')
+        return false;
+    if (typeof credential.id !== 'string' || !Array.isArray(credential.origins))
+        return false;
+    if (credential.type === 'request')
+        return typeof credential.authenticate === 'function';
+    return ((credential.type === 'header' || credential.type === 'query-parameter') &&
+        typeof credential.name === 'string' &&
+        (typeof credential.token === 'string' || typeof credential.token === 'function') &&
+        Array.isArray(credential.refreshStatusCodes));
+}
+//# sourceMappingURL=authentication.js.map

package/dist/loader-utils/lib/request-utils/authentication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/request-utils/authentication.ts"],"names":[],"mappings":"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"}

package/dist/loader-utils/lib/request-utils/parse-content-type.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Normalize a Content-Type header into a lowercased media type string.
+ * @param contentTypeHeader - Raw Content-Type header value.
+ * @returns Lowercased media type, or null when not available.
+ */
+export declare function parseContentType(contentTypeHeader?: string | null): string | null;
+//# sourceMappingURL=parse-content-type.d.ts.map

package/dist/loader-utils/lib/request-utils/parse-content-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-content-type.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/request-utils/parse-content-type.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAYjF"}

package/dist/loader-utils/lib/request-utils/parse-content-type.js

@@ -0,0 +1,20 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Normalize a Content-Type header into a lowercased media type string.
+ * @param contentTypeHeader - Raw Content-Type header value.
+ * @returns Lowercased media type, or null when not available.
+ */
+export function parseContentType(contentTypeHeader) {
+    if (!contentTypeHeader) {
+        return null;
+    }
+    const trimmedValue = contentTypeHeader.trim();
+    if (!trimmedValue) {
+        return null;
+    }
+    const contentType = trimmedValue.split(';')[0]?.trim().toLowerCase();
+    return contentType || null;
+}
+//# sourceMappingURL=parse-content-type.js.map

package/dist/loader-utils/lib/request-utils/parse-content-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-content-type.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/request-utils/parse-content-type.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,iBAAiC;IAChE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrE,OAAO,WAAW,IAAI,IAAI,CAAC;AAC7B,CAAC"}

package/dist/loader-utils/lib/request-utils/range-request-cache.d.ts

@@ -0,0 +1,70 @@
+/** Event emitted by a {@link RangeRequestCache}. */
+export type RangeRequestCacheEvent = {
+    /** Cache operation represented by this event. */
+    type: 'hit' | 'miss' | 'store' | 'evict';
+    /** Stable identifier for the byte-addressable source. */
+    sourceId: string;
+    /** Requested or stored byte offset. */
+    offset: number;
+    /** Requested or stored byte length. */
+    length: number;
+};
+/** Options for {@link RangeRequestCache}. */
+export type RangeRequestCacheProps = {
+    /** Maximum number of settled ranges retained. */
+    maxEntries?: number;
+    /** Maximum bytes retained across settled ranges. */
+    maxBytes?: number;
+    /** Called for cache hits, misses, stores, and evictions. */
+    onEvent?: (event: RangeRequestCacheEvent) => void;
+};
+/** One byte-range request handled by {@link RangeRequestCache.read}. */
+export type CachedRangeRequest = {
+    /** Stable identifier for the byte-addressable source and object version. */
+    sourceId: string;
+    /** Start byte offset. */
+    offset: number;
+    /** Number of bytes to read. */
+    length: number;
+    /** Optional caller cancellation signal. */
+    signal?: AbortSignal;
+    /** Fetches one exact byte range when it is not cached. */
+    fetchRange: (offset: number, length: number, signal: AbortSignal) => Promise<ArrayBuffer>;
+};
+/**
+ * LRU cache for immutable byte ranges.
+ *
+ * Exact and contained reads share cached storage while every caller receives a standalone copy.
+ * Concurrent exact reads share one abort-aware request. Use a source id that includes an ETag or
+ * equivalent version when a URL can change during the cache lifetime.
+ */
+export declare class RangeRequestCache {
+    private readonly cache;
+    private readonly rangesBySource;
+    private readonly onEvent?;
+    /** Creates a bounded byte-range cache. */
+    constructor(props?: RangeRequestCacheProps);
+    /** Number of pending and settled ranges tracked by this cache. */
+    get size(): number;
+    /** Maximum bytes retained across settled range entries. */
+    get maxBytes(): number;
+    /** Number of byte-range requests that have not settled. */
+    get pendingSize(): number;
+    /** Bytes retained by settled range entries. */
+    get byteLength(): number;
+    /** Seeds one completed byte range and copies it into cache-owned storage. */
+    set(sourceId: string, offset: number, arrayBuffer: ArrayBuffer): void;
+    /** Returns an exact or contained cached range as a standalone buffer. */
+    get(sourceId: string, offset: number, length: number, signal?: AbortSignal): Promise<ArrayBuffer | undefined>;
+    /** Returns a cached range or loads and retains one exact range. */
+    read(request: CachedRangeRequest): Promise<ArrayBuffer>;
+    /** Removes every range associated with one source or object version. */
+    deleteSource(sourceId: string): void;
+    /** Aborts pending range requests and clears retained bytes. */
+    clear(): void;
+    private findContainingRange;
+    private registerRange;
+    private handleRemoval;
+    private unregisterRange;
+}
+//# sourceMappingURL=range-request-cache.d.ts.map

package/dist/loader-utils/lib/request-utils/range-request-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-request-cache.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/request-utils/range-request-cache.ts"],"names":[],"mappings":"AAMA,oDAAoD;AACpD,MAAM,MAAM,sBAAsB,GAAG;IACnC,iDAAiD;IACjD,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,sBAAsB,GAAG;IACnC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3F,CAAC;AASF;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAC9E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0C;IAEnE,0CAA0C;gBAC9B,KAAK,GAAE,sBAA2B;IAU9C,kEAAkE;IAClE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,2DAA2D;IAC3D,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,2DAA2D;IAC3D,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,+CAA+C;IAC/C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,6EAA6E;IAC7E,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI;IAerE,yEAAyE;IACnE,GAAG,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAcnC,mEAAmE;IAC7D,IAAI,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IA6C7D,wEAAwE;IACxE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQpC,+DAA+D;IAC/D,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,eAAe;CAOxB"}

package/dist/loader-utils/lib/request-utils/range-request-cache.js

@@ -0,0 +1,203 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { RequestCache } from "./request-cache.js";
+/**
+ * LRU cache for immutable byte ranges.
+ *
+ * Exact and contained reads share cached storage while every caller receives a standalone copy.
+ * Concurrent exact reads share one abort-aware request. Use a source id that includes an ETag or
+ * equivalent version when a URL can change during the cache lifetime.
+ */
+export class RangeRequestCache {
+    cache;
+    rangesBySource = new Map();
+    onEvent;
+    /** Creates a bounded byte-range cache. */
+    constructor(props = {}) {
+        this.onEvent = props.onEvent;
+        this.cache = new RequestCache({
+            maxEntries: props.maxEntries,
+            maxBytes: props.maxBytes,
+            getByteLength: range => range.length,
+            onRemove: (key, reason) => this.handleRemoval(key, reason)
+        });
+    }
+    /** Number of pending and settled ranges tracked by this cache. */
+    get size() {
+        return this.cache.size;
+    }
+    /** Maximum bytes retained across settled range entries. */
+    get maxBytes() {
+        return this.cache.maxBytes;
+    }
+    /** Number of byte-range requests that have not settled. */
+    get pendingSize() {
+        return this.cache.pendingSize;
+    }
+    /** Bytes retained by settled range entries. */
+    get byteLength() {
+        return this.cache.byteLength;
+    }
+    /** Seeds one completed byte range and copies it into cache-owned storage. */
+    set(sourceId, offset, arrayBuffer) {
+        validateRange(offset, arrayBuffer.byteLength);
+        const range = {
+            sourceId,
+            offset,
+            length: arrayBuffer.byteLength,
+            arrayBuffer: arrayBuffer.slice(0)
+        };
+        const key = getRangeKey(sourceId, offset, range.length);
+        this.cache.delete(key);
+        this.registerRange(key, range);
+        this.cache.set(key, range);
+        this.onEvent?.({ type: 'store', sourceId, offset, length: range.length });
+    }
+    /** Returns an exact or contained cached range as a standalone buffer. */
+    async get(sourceId, offset, length, signal) {
+        validateRange(offset, length);
+        const match = this.findContainingRange(sourceId, offset, length);
+        if (!match) {
+            return undefined;
+        }
+        const range = await this.cache.get(match.key, signal);
+        if (!range) {
+            return undefined;
+        }
+        this.onEvent?.({ type: 'hit', sourceId, offset, length });
+        return sliceRange(range, offset, length);
+    }
+    /** Returns a cached range or loads and retains one exact range. */
+    async read(request) {
+        const { sourceId, offset, length, signal, fetchRange } = request;
+        const cached = await this.get(sourceId, offset, length, signal);
+        if (cached) {
+            return cached;
+        }
+        this.onEvent?.({ type: 'miss', sourceId, offset, length });
+        if (this.cache.maxEntries === 0 || length > this.cache.maxBytes) {
+            if (signal?.aborted) {
+                throw createAbortError();
+            }
+            const arrayBuffer = await fetchRange(offset, length, signal || new AbortController().signal);
+            validateResponseLength(arrayBuffer, length);
+            return arrayBuffer;
+        }
+        const key = getRangeKey(sourceId, offset, length);
+        const placeholder = {
+            sourceId,
+            offset,
+            length,
+            arrayBuffer: new ArrayBuffer(0)
+        };
+        this.registerRange(key, placeholder);
+        try {
+            const range = await this.cache.getOrLoad(key, async (cacheSignal) => {
+                const arrayBuffer = await fetchRange(offset, length, cacheSignal);
+                validateResponseLength(arrayBuffer, length);
+                const loadedRange = { ...placeholder, arrayBuffer };
+                this.registerRange(key, loadedRange);
+                this.onEvent?.({ type: 'store', sourceId, offset, length });
+                return loadedRange;
+            }, signal);
+            return sliceRange(range, offset, length);
+        }
+        catch (error) {
+            if (!this.cache.has(key)) {
+                this.unregisterRange(key, sourceId);
+            }
+            throw error;
+        }
+    }
+    /** Removes every range associated with one source or object version. */
+    deleteSource(sourceId) {
+        const ranges = this.rangesBySource.get(sourceId);
+        if (!ranges)
+            return;
+        for (const key of Array.from(ranges.keys())) {
+            this.cache.delete(key);
+        }
+    }
+    /** Aborts pending range requests and clears retained bytes. */
+    clear() {
+        this.cache.clear();
+        this.rangesBySource.clear();
+    }
+    findContainingRange(sourceId, offset, length) {
+        const ranges = this.rangesBySource.get(sourceId);
+        if (!ranges)
+            return undefined;
+        const endOffset = offset + length;
+        let match;
+        for (const [key, range] of ranges) {
+            if (range.offset <= offset &&
+                range.offset + range.length >= endOffset &&
+                (!match || range.length < match.range.length)) {
+                match = { key, range };
+            }
+        }
+        return match;
+    }
+    registerRange(key, range) {
+        let ranges = this.rangesBySource.get(range.sourceId);
+        if (!ranges) {
+            ranges = new Map();
+            this.rangesBySource.set(range.sourceId, ranges);
+        }
+        ranges.set(key, range);
+    }
+    handleRemoval(key, reason) {
+        for (const [sourceId, ranges] of this.rangesBySource) {
+            const range = ranges.get(key);
+            if (!range)
+                continue;
+            ranges.delete(key);
+            if (ranges.size === 0) {
+                this.rangesBySource.delete(sourceId);
+            }
+            if (reason === 'evict') {
+                this.onEvent?.({ type: 'evict', sourceId, offset: range.offset, length: range.length });
+            }
+            return;
+        }
+    }
+    unregisterRange(key, sourceId) {
+        const ranges = this.rangesBySource.get(sourceId);
+        ranges?.delete(key);
+        if (ranges?.size === 0) {
+            this.rangesBySource.delete(sourceId);
+        }
+    }
+}
+/** Returns a stable exact-range cache key. */
+function getRangeKey(sourceId, offset, length) {
+    return `${sourceId}\u0000${offset}:${length}`;
+}
+/** Copies one requested interval out of a cached containing range. */
+function sliceRange(range, offset, length) {
+    const relativeOffset = offset - range.offset;
+    return range.arrayBuffer.slice(relativeOffset, relativeOffset + length);
+}
+/** Validates one non-negative safe-integer byte range. */
+function validateRange(offset, length) {
+    if (!Number.isSafeInteger(offset) || !Number.isSafeInteger(length) || offset < 0 || length < 0) {
+        throw new Error('Byte ranges must use non-negative safe integers');
+    }
+    if (!Number.isSafeInteger(offset + length)) {
+        throw new Error('Byte range end must be a safe integer');
+    }
+}
+/** Rejects transport responses that do not exactly cover the requested range. */
+function validateResponseLength(arrayBuffer, expectedLength) {
+    if (arrayBuffer.byteLength !== expectedLength) {
+        throw new Error(`Range request returned ${arrayBuffer.byteLength} bytes; expected ${expectedLength}`);
+    }
+}
+/** Creates the standard abort error for an already-cancelled uncached range read. */
+function createAbortError() {
+    const error = new Error('Request aborted');
+    error.name = 'AbortError';
+    return error;
+}
+//# sourceMappingURL=range-request-cache.js.map

package/dist/loader-utils/lib/request-utils/range-request-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-request-cache.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/request-utils/range-request-cache.ts"],"names":[],"mappings":"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"}

package/dist/loader-utils/lib/request-utils/range-request-scheduler.d.ts

@@ -0,0 +1,201 @@
+import { Stats } from 'probe.gl/stats';
+/** Typed snapshot of the byte-range scheduler counters stored in a probe.gl `Stats` object. */
+export type RangeStats = {
+    /** Number of caller-requested byte ranges. */
+    logicalRanges: number;
+    /** Number of queue flushes that produced at least one transport request. */
+    rangeBatches: number;
+    /** Number of merged byte ranges requested from the transport. */
+    transportRanges: number;
+    /** Number of merged byte ranges that completed successfully. */
+    completedTransportRanges: number;
+    /** Number of logical ranges eliminated by coalescing. */
+    coalescedRanges: number;
+    /** Number of bytes requested by callers before coalescing. */
+    requestedBytes: number;
+    /** Number of bytes requested from the transport after coalescing and expansion. */
+    transportBytes: number;
+    /** Number of bytes read from transport responses. */
+    responseBytes: number;
+    /** Aggregate time spent awaiting transport requests, in milliseconds. */
+    networkTimeMs: number;
+    /** Number of transport-requested bytes that were not part of logical caller requests. */
+    overfetchBytes: number;
+    /** Number of transport ranges that failed. */
+    failedTransportRanges: number;
+    /** Number of logical byte ranges aborted before completion. */
+    abortedLogicalRanges: number;
+    /** Number of transport responses that returned a full-object fallback. */
+    fullResponseFallbacks: number;
+};
+/** Options for the byte-range request scheduler. */
+export type RangeRequestSchedulerProps = {
+    /** Fixed window from the first queued range; later arrivals and completions do not extend it. */
+    batchDelayMs?: number;
+    /** Maximum byte gap that can be over-fetched when merging two adjacent requests. */
+    maxGapBytes?: number;
+    /** Maximum byte gap that can be over-fetched when expanding one range to include the next request. */
+    rangeExpansionBytes?: number;
+    /** Maximum total byte length of one merged range request. */
+    maxMergedBytes?: number;
+    /** Maximum simultaneous transports; defaults to six. */
+    maxConcurrency?: number;
+    /** Maximum unsettled logical requests; defaults to 4096. */
+    maxQueueSize?: number;
+    /** Maximum individual logical range length; defaults to 64 MiB. */
+    maxRangeBytes?: number;
+    /** Lifetime budget for merged transport spans, including gaps and failed/canceled reads; default MAX_SAFE_INTEGER. */
+    maxTotalBytes?: number;
+    /** Optional probe.gl Stats object that receives range batching counters. */
+    stats?: Stats;
+    /** Optional event callback for range batching diagnostics. */
+    onEvent?: (event: RangeRequestEvent) => void;
+};
+/** One logical byte-range request handled by `RangeRequestScheduler.scheduleRequest()`. */
+export type RangeRequest = {
+    /** Stable identifier for the remote byte-range-addressable resource. */
+    sourceId: string;
+    /** Start byte offset. */
+    offset: number;
+    /** Number of bytes to read. */
+    length: number;
+    /** Optional caller abort signal. */
+    signal?: AbortSignal;
+    /** Requests only coalesce when this key is identical. Defaults to the shared source identifier. */
+    isolationKey?: unknown;
+    /** Fetches bytes for this source. */
+    fetchRange: (offset: number, length: number, signal?: AbortSignal) => Promise<ArrayBuffer | RangeRequestTransportResult>;
+};
+/** HTTP byte-range request handled by `RangeRequestScheduler.fetch()`. */
+export type RangeFetchRequest = {
+    /** URL of the remote byte-range-addressable resource. */
+    url: string;
+    /** Optional stable identifier for the remote resource; defaults to `url`. */
+    sourceId?: string;
+    /** Start byte offset. */
+    offset: number;
+    /** Number of bytes to read. */
+    length: number;
+    /** Optional caller abort signal. */
+    signal?: AbortSignal;
+    /** Requests only coalesce when this key is identical. Omit it to isolate this fetch call. */
+    isolationKey?: unknown;
+    /** Optional fetch implementation for tests or host environments. */
+    fetch?: (url: string, options?: RequestInit) => Promise<Response>;
+    /** Optional fetch options merged into the transport request. */
+    fetchOptions?: RequestInit;
+};
+/** Transport result plus diagnostics for one merged byte-range request. */
+export type RangeRequestTransportResult = {
+    /** Bytes returned by the transport. */
+    arrayBuffer: ArrayBuffer;
+    /** HTTP status code or transport-specific equivalent. */
+    status?: number;
+    /** Total source length, when known. Used to validate a response clamped at end of file. */
+    sourceByteLength?: number;
+    /** Number of response bytes read from the transport before slicing. */
+    transportBytes?: number;
+    /** Time spent awaiting this transport request, in milliseconds. */
+    networkTimeMs?: number;
+    /** True when the transport returned the complete object and the requested range was sliced locally. */
+    fullResponse?: boolean;
+};
+/** Diagnostic event emitted by the byte-range request scheduler. */
+export type RangeRequestEvent = {
+    /** Event type. */
+    type: 'queued' | 'batch' | 'request' | 'response' | 'error' | 'abort';
+    /** Stable identifier for the remote byte-range-addressable resource. */
+    sourceId?: string;
+    /** Start byte offset of a merged transport request. */
+    offset?: number;
+    /** Byte length of a merged transport request. */
+    length?: number;
+    /** Number of caller requests in a batch or merged request. */
+    logicalRequestCount?: number;
+    /** Number of merged transport requests created for a batch. */
+    transportRequestCount?: number;
+    /** Sum of caller-requested bytes. */
+    logicalBytes?: number;
+    /** Bytes requested from the transport after merging and expansion. */
+    transportBytes?: number;
+    /** Bytes returned by the transport before slicing. */
+    responseBytes?: number;
+    /** Time spent awaiting the transport request, in milliseconds. */
+    networkTimeMs?: number;
+    /** Bytes fetched only to bridge nearby requested ranges. */
+    overfetchBytes?: number;
+    /** HTTP status code or transport-specific equivalent. */
+    status?: number;
+    /** True when the transport returned the complete object and a requested range was sliced locally. */
+    fullResponse?: boolean;
+    /** Error thrown by one merged transport request. */
+    error?: unknown;
+};
+/**
+ * Coalesces nearby byte range requests and carves the merged response back
+ * into the originally requested byte ranges.
+ */
+export declare class RangeRequestScheduler {
+    /** Runtime scheduler configuration with defaults filled in. */
+    readonly props: Required<Omit<RangeRequestSchedulerProps, 'stats' | 'onEvent'>>;
+    /** Runtime counters for range batching and transport behavior. */
+    readonly stats: Stats;
+    /** Optional event callback for range batching diagnostics. */
+    readonly onEvent?: (event: RangeRequestEvent) => void;
+    private pendingRequests;
+    /** Merged transports waiting for a concurrency slot. */
+    private transportQueue;
+    /** Number of active transports. */
+    private activeTransports;
+    /** Bytes reserved by started transports; failures and cancellation do not refund this budget. */
+    private reservedTransportBytes;
+    /** Number of unsettled logical requests. */
+    private queuedRequests;
+    /** Unsettled requests retained until completion or disposal. */
+    private logicalRequests;
+    /** Controllers for transports owned by this scheduler. */
+    private transportControllers;
+    /** Disposal prevents further enqueueing. */
+    private finalized;
+    /** Pending batch window, independent of in-flight transport requests. */
+    private flushTimer;
+    /** Creates a scheduler for one group of byte-range-addressable resources. */
+    constructor(props?: RangeRequestSchedulerProps);
+    /**
+     * Enqueues one byte range request and resolves with the exact requested byte slice.
+     */
+    scheduleRequest(request: RangeRequest): Promise<ArrayBuffer>;
+    /**
+     * Enqueues one HTTP byte-range request and resolves with the exact requested byte slice.
+     */
+    fetch(request: RangeFetchRequest): Promise<ArrayBuffer>;
+    /** Immediately starts loading the currently queued requests. */
+    flush(): void;
+    /** Cancels owned work and releases queued resources; borrowed users must not finalize shared schedulers. */
+    finalize(): void;
+    /** Starts transports while respecting the configured concurrency bound. */
+    private startQueuedTransports;
+    /** Starts a fixed batch window only when no flush is already scheduled. */
+    private scheduleFlush;
+    /** Sorts active requests and combines requests for the same source when thresholds allow. */
+    private mergeRequests;
+    /** Loads one merged range and resolves each child request with its sliced bytes. */
+    private fetchMergedRequest;
+    /** Rejects and tracks one logical request exactly once when its caller aborts. */
+    private abortRequest;
+    /** Emits one event to Stats and to the optional callback. */
+    private trackEvent;
+    /** Emits one batch event after logical requests have been merged. */
+    private trackBatch;
+}
+/**
+ * Tracks range batching events in a probe.gl Stats object.
+ */
+export declare function trackStatsEvent(stats: Stats, event: RangeRequestEvent): void;
+/** Creates a probe.gl `Stats` object initialized with byte-range scheduler counters. */
+export declare function createRangeStats(id?: string): Stats;
+/** Reads byte-range scheduler counters from a probe.gl `Stats` object. */
+export declare function getRangeStats(stats: Stats): RangeStats;
+/** Issues one HTTP range request and parses range-related status/header behavior. */
+export declare function fetchHttpRange(request: Required<Pick<RangeFetchRequest, 'url' | 'fetch'>> & Pick<RangeFetchRequest, 'offset' | 'length' | 'signal' | 'fetchOptions'>): Promise<RangeRequestTransportResult>;
+//# sourceMappingURL=range-request-scheduler.d.ts.map

package/dist/loader-utils/lib/request-utils/range-request-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-request-scheduler.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/request-utils/range-request-scheduler.ts"],"names":[],"mappings":"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"}