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

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

@@ -0,0 +1,379 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { resolveCredentials } from "./authentication.js";
+const DEFAULT_REFRESH_STATUS_CODES = [401, 403];
+const AUTHENTICATED_FETCH = Symbol('loaders.gl.authenticated-fetch');
+const refreshPromises = new WeakMap();
+/** Creates a token credential placed in a URL query parameter. */
+export function createQueryParameterCredential(options) {
+    return {
+        id: options.id,
+        origins: normalizeOrigins(options.origins),
+        type: 'query-parameter',
+        name: options.parameterName,
+        token: options.token,
+        refreshStatusCodes: options.refreshStatusCodes || DEFAULT_REFRESH_STATUS_CODES
+    };
+}
+/** Creates a token credential placed in an HTTP bearer header. */
+export function createBearerTokenCredential(options) {
+    return {
+        id: options.id,
+        origins: normalizeOrigins(options.origins),
+        type: 'header',
+        name: options.headerName || 'Authorization',
+        prefix: options.prefix ?? 'Bearer ',
+        token: options.token,
+        refreshStatusCodes: options.refreshStatusCodes || DEFAULT_REFRESH_STATUS_CODES
+    };
+}
+/** Base for authentication classes that adapt configuration to a token credential. */
+export class TokenAuthentication {
+    /** Stable identifier used in diagnostics. */
+    id;
+    /** Exact origins authorized to receive the token. */
+    origins;
+    /** Transport placement of the token. */
+    type;
+    /** Header or query parameter name. */
+    name;
+    /** Optional prefix for header values. */
+    prefix;
+    /** Static token or application-managed token provider. */
+    token;
+    /** Statuses that permit one refresh and replay. */
+    refreshStatusCodes;
+    /** Provider-specific response failure detection. */
+    shouldRefresh;
+    /** Provider-specific read-only request replay predicate. */
+    canReplayRequest;
+    /** Initializes the instance from an existing transport credential. */
+    constructor(credential) {
+        this.id = credential.id;
+        this.origins = credential.origins;
+        this.type = credential.type;
+        this.name = credential.name;
+        this.prefix = credential.prefix;
+        this.token = credential.token;
+        this.refreshStatusCodes = credential.refreshStatusCodes;
+        this.shouldRefresh = credential.shouldRefresh;
+        this.canReplayRequest = credential.canReplayRequest;
+    }
+}
+/** Instantiates a query-token credential from declarative configuration. */
+export class QueryParameterAuthentication extends TokenAuthentication {
+    /** Discriminator used in `core.credentials`. */
+    static type = 'query-parameter';
+    /** Creates a scoped query-token credential. */
+    constructor(options) {
+        super(createQueryParameterCredential(options));
+    }
+}
+/** Instantiates a bearer credential from declarative configuration. */
+export class BearerTokenAuthentication extends TokenAuthentication {
+    /** Discriminator used in `core.credentials`. */
+    static type = 'bearer-token';
+    /** Creates a scoped bearer credential. */
+    constructor(options) {
+        super(createBearerTokenCredential(options));
+    }
+}
+/** Wraps a fetch function with exact-origin credential application and one refresh replay. */
+export function createAuthenticatedFetch(options) {
+    const suppliedFetch = options.fetch || ((url, requestOptions) => fetch(url, requestOptions));
+    const existingMetadata = suppliedFetch[AUTHENTICATED_FETCH];
+    const credentialResolutions = new Map(existingMetadata?.credentialResolutions);
+    const resolvedCredentials = resolveCredentials(options.credentials.map(credential => credentialResolutions.get(credential) || credential), options.authentications);
+    options.credentials.forEach((credential, index) => {
+        credentialResolutions.set(credential, resolvedCredentials[index]);
+    });
+    if (!options.fetchOptions &&
+        (!resolvedCredentials.length ||
+            (existingMetadata?.credentials.length === resolvedCredentials.length &&
+                resolvedCredentials.every((credential, index) => credential === existingMetadata.credentials[index]))))
+        return suppliedFetch;
+    const baseFetch = existingMetadata?.fetch || suppliedFetch;
+    const credentials = existingMetadata
+        ? [...new Set([...resolvedCredentials, ...existingMetadata.credentials])]
+        : resolvedCredentials;
+    const fetchOptions = mergeFetchOptions(existingMetadata?.fetchOptions || {}, options.fetchOptions);
+    const tokenCredentials = credentials.filter((credential) => credential.type !== 'request');
+    const requestCredentials = credentials.filter((credential) => credential.type === 'request');
+    // Validate scopes before any request, including custom scheme authorities for callbacks.
+    for (const credential of requestCredentials)
+        normalizeRequestOrigins(credential.origins);
+    const authenticatedFetch = async (url, requestOptions = {}) => {
+        requestOptions = mergeFetchOptions(fetchOptions, requestOptions);
+        if (requestOptions.signal?.aborted)
+            throw createAbortError();
+        // Request defaults alone must not normalize URLs or defer the transport invocation.
+        if (!credentials.length)
+            return baseFetch(url, requestOptions);
+        const resolvedURL = parseHTTPURL(url);
+        const authorization = resolvedURL
+            ? await authorizeRequest(resolvedURL, requestOptions, tokenCredentials)
+            : { url, options: requestOptions, credentials: [] };
+        const signedRequest = await authenticateRequest(authorization, requestCredentials, 'request');
+        const response = await baseFetch(signedRequest.url, signedRequest.options);
+        const refreshableCredentials = [];
+        for (const resolvedCredential of authorization.credentials) {
+            const { credential } = resolvedCredential;
+            if (typeof credential.token === 'function' &&
+                (isReplayableRequest(requestOptions) ||
+                    credential.canReplayRequest?.(url, requestOptions)) &&
+                (isReplayableRequest(signedRequest.options) ||
+                    credential.canReplayRequest?.(signedRequest.url, signedRequest.options)) &&
+                (credential.refreshStatusCodes.includes(response.status) ||
+                    (await credential.shouldRefresh?.(response))))
+                refreshableCredentials.push(resolvedCredential);
+        }
+        const shouldRetrySignature = isReplayableRequest(requestOptions) &&
+            isReplayableRequest(signedRequest.options) &&
+            signedRequest.credentials.some(credential => credential.refreshStatusCodes?.includes(response.status));
+        if (!refreshableCredentials.length && !shouldRetrySignature)
+            return response;
+        if (requestOptions.signal?.aborted)
+            throw createAbortError();
+        const refreshedTokens = new Map();
+        await Promise.all(refreshableCredentials.map(async ({ credential }) => {
+            const token = await refreshCredential(credential, url, response);
+            if (token)
+                refreshedTokens.set(credential, token);
+        }));
+        if (!refreshedTokens.size && !shouldRetrySignature)
+            return response;
+        await response.body?.cancel().catch(() => { });
+        if (requestOptions.signal?.aborted)
+            throw createAbortError();
+        const replayAuthorization = resolvedURL
+            ? await authorizeRequest(resolvedURL, requestOptions, tokenCredentials, refreshedTokens, authorization.credentials)
+            : { url, options: requestOptions };
+        const replayRequest = await authenticateRequest(replayAuthorization, requestCredentials, 'retry', response);
+        return baseFetch(replayRequest.url, replayRequest.options);
+    };
+    Object.defineProperty(authenticatedFetch, AUTHENTICATED_FETCH, {
+        value: {
+            fetch: baseFetch,
+            credentials,
+            credentialResolutions,
+            fetchOptions
+        }
+    });
+    return authenticatedFetch;
+}
+/**
+ * Creates a credential-aware fetch function from standard loader options.
+ * @param options Loader options containing an optional fetch override and scoped credentials.
+ * @returns A fetch function that preserves request defaults and applies matching credentials.
+ */
+export function getAuthenticatedFetch(options = {}) {
+    const fetchOption = options.fetch ?? options.core?.fetch;
+    let fetchFunction;
+    if (typeof fetchOption === 'function') {
+        fetchFunction = fetchOption;
+    }
+    else {
+        fetchFunction = (url, requestOptions) => fetch(url, requestOptions);
+    }
+    return createAuthenticatedFetch({
+        fetch: fetchFunction,
+        fetchOptions: typeof fetchOption === 'object' && fetchOption ? fetchOption : undefined,
+        credentials: options.core?.credentials || [],
+        authentications: options.core?.authentications
+    });
+}
+/** Combines default and per-request fetch options without replacing either header collection. */
+function mergeFetchOptions(defaultOptions, requestOptions) {
+    const mergedOptions = { ...defaultOptions, ...requestOptions };
+    if (defaultOptions.headers || requestOptions?.headers) {
+        const headers = new Headers(defaultOptions.headers);
+        new Headers(requestOptions?.headers).forEach((value, key) => headers.set(key, value));
+        mergedOptions.headers = headers;
+    }
+    return mergedOptions;
+}
+/** Redacts credential-bearing query parameters from a URL used in diagnostics. */
+export function redactCredentialURL(url, credentials) {
+    const resolvedURL = parseHTTPURL(url);
+    if (!resolvedURL)
+        return url;
+    if (credentials.some(credential => credential.type === 'request')) {
+        // A signer can rewrite the destination; its input scope cannot identify output URLs.
+        for (const name of [...resolvedURL.searchParams.keys()]) {
+            resolvedURL.searchParams.set(name, '[REDACTED]');
+        }
+    }
+    for (const credential of credentials) {
+        if (credential.type === 'query-parameter' &&
+            Array.isArray(credential.origins) &&
+            credential.origins.includes(resolvedURL.origin) &&
+            typeof credential.name === 'string' &&
+            resolvedURL.searchParams.has(credential.name)) {
+            resolvedURL.searchParams.set(credential.name, '[REDACTED]');
+        }
+    }
+    return resolvedURL.toString();
+}
+/** Applies request callbacks after token placement, preserving cancellation across URL rewrites. */
+async function authenticateRequest(request, credentials, reason, response) {
+    const appliedCredentials = [];
+    const signal = request.options.signal;
+    for (const credential of credentials) {
+        const origin = getRequestOrigin(request.url);
+        if (!origin || !normalizeRequestOrigins(credential.origins).includes(origin))
+            continue;
+        if (signal?.aborted)
+            throw createAbortError();
+        const authenticatedRequest = await credential.authenticate({
+            url: request.url,
+            options: { ...request.options, headers: new Headers(request.options.headers) },
+            reason,
+            response: response
+                ? { status: response.status, headers: new Headers(response.headers) }
+                : undefined
+        });
+        if (!authenticatedRequest ||
+            typeof authenticatedRequest.url !== 'string' ||
+            !authenticatedRequest.options ||
+            typeof authenticatedRequest.options !== 'object') {
+            throw new Error('Authentication callback returned an invalid request.');
+        }
+        request = {
+            url: authenticatedRequest.url,
+            options: { ...authenticatedRequest.options, ...(signal ? { signal } : {}) }
+        };
+        appliedCredentials.push(credential);
+    }
+    if (signal?.aborted)
+        throw createAbortError();
+    return { ...request, credentials: appliedCredentials };
+}
+/** Returns an exact origin or custom-scheme authority without collapsing opaque URL origins. */
+function getRequestOrigin(url) {
+    try {
+        const parsedURL = new URL(url);
+        if (!parsedURL.host || parsedURL.username || parsedURL.password)
+            return null;
+        return parsedURL.origin !== 'null'
+            ? parsedURL.origin
+            : `${parsedURL.protocol}//${parsedURL.host}`;
+    }
+    catch {
+        return null;
+    }
+}
+/** Validates callback scopes, including custom scheme authorities such as `s3://bucket`. */
+function normalizeRequestOrigins(origins) {
+    if (!origins.length)
+        throw new Error('Request authentication requires at least one exact origin.');
+    return origins.map(origin => {
+        const resolvedOrigin = getRequestOrigin(origin);
+        let url;
+        try {
+            url = new URL(origin);
+        }
+        catch {
+            throw new Error('Invalid request authentication origin.');
+        }
+        if (!resolvedOrigin || (url.pathname && url.pathname !== '/') || url.search || url.hash) {
+            throw new Error('Invalid request authentication origin.');
+        }
+        return resolvedOrigin;
+    });
+}
+/** Resolves matching tokens and applies them to a fresh URL and header collection. */
+async function authorizeRequest(sourceURL, requestOptions, credentials, tokenOverrides = new Map(), previousCredentials = []) {
+    const url = new URL(sourceURL);
+    const headers = new Headers(requestOptions.headers);
+    const resolvedCredentials = [];
+    const previousTokens = new Map(previousCredentials.map(({ credential, token }) => [credential, token]));
+    for (const credential of credentials) {
+        if (!credential.origins.includes(url.origin))
+            continue;
+        const overrideToken = tokenOverrides.get(credential);
+        const previousToken = previousTokens.get(credential);
+        const ownsQueryParameter = credential.type === 'query-parameter' && previousToken !== undefined;
+        const ownsHeader = credential.type === 'header' && previousToken !== undefined;
+        if ((credential.type === 'query-parameter' &&
+            url.searchParams.has(credential.name) &&
+            !ownsQueryParameter) ||
+            (credential.type === 'header' && headers.has(credential.name) && !ownsHeader)) {
+            continue;
+        }
+        const token = overrideToken ??
+            previousToken ??
+            (await resolveToken(credential.token, { url: sourceURL.toString(), reason: 'request' }));
+        if (!token)
+            continue;
+        if (credential.type === 'query-parameter') {
+            url.searchParams.set(credential.name, token);
+        }
+        else {
+            headers.set(credential.name, `${credential.prefix || ''}${token}`);
+        }
+        resolvedCredentials.push({ credential, token });
+    }
+    return {
+        url: url.toString(),
+        options: { ...requestOptions, headers },
+        credentials: resolvedCredentials
+    };
+}
+/** Shares one in-flight refresh for concurrent requests using the same credential object. */
+async function refreshCredential(credential, url, response) {
+    const existingPromise = refreshPromises.get(credential);
+    if (existingPromise)
+        return existingPromise;
+    const tokenProvider = credential.token;
+    const promise = Promise.resolve(tokenProvider({
+        url,
+        reason: 'refresh',
+        response: { status: response.status, headers: response.headers }
+    })).finally(() => refreshPromises.delete(credential));
+    refreshPromises.set(credential, promise);
+    return promise;
+}
+/** Resolves a static token or invokes an application token provider. */
+async function resolveToken(token, context) {
+    return typeof token === 'function' ? token(context) : token;
+}
+/** Validates and canonicalizes an exact-origin allowlist. */
+function normalizeOrigins(origins) {
+    if (!origins.length)
+        throw new Error('Request credentials require at least one exact origin.');
+    return origins.map(origin => {
+        const url = new URL(origin);
+        if (!['http:', 'https:'].includes(url.protocol) ||
+            url.pathname !== '/' ||
+            url.search ||
+            url.hash) {
+            throw new Error(`Credential origin must contain only scheme, host, and port: ${origin}`);
+        }
+        return url.origin;
+    });
+}
+/** Parses an HTTP(S) URL without throwing for other fetch-compatible inputs. */
+function parseHTTPURL(url) {
+    try {
+        const parsedURL = new URL(url);
+        return ['http:', 'https:'].includes(parsedURL.protocol) ? parsedURL : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Returns whether a failed request can safely reuse its method and body once. */
+function isReplayableRequest(options) {
+    const method = (options.method || 'GET').toUpperCase();
+    if (!['GET', 'HEAD', 'OPTIONS', 'PUT', 'DELETE'].includes(method))
+        return false;
+    return !(options.body &&
+        typeof ReadableStream !== 'undefined' &&
+        options.body instanceof ReadableStream);
+}
+/** Creates the standard DOM exception used for an aborted fetch. */
+function createAbortError() {
+    return new DOMException('The operation was aborted.', 'AbortError');
+}
+//# sourceMappingURL=request-credentials.js.map

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

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

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

@@ -0,0 +1,71 @@
+import { Stats } from 'probe.gl/stats';
+type Handle = any;
+type DoneFunction = () => any;
+type GetPriorityFunction = () => number;
+type RequestResult = {
+    done: DoneFunction;
+} | null;
+/** RequestScheduler Options */
+export type RequestSchedulerProps = {
+    id?: string;
+    throttleRequests?: boolean;
+    maxRequests?: number;
+    /** Quiet period after the most recent new request; completions never restart this timer. */
+    debounceTime?: number;
+};
+/** Tracks one request */
+type Request = {
+    handle: Handle;
+    priority: number;
+    getPriority: GetPriorityFunction;
+    resolve?: (value: any) => any;
+};
+/**
+ * Used to issue a request, without having them "deeply queued" by the browser.
+ * @todo - Track requests globally, across multiple servers
+ */
+export default class RequestScheduler {
+    readonly props: Required<RequestSchedulerProps>;
+    readonly stats: Stats;
+    activeRequestCount: number;
+    /** Tracks the number of active requests and prioritizes/cancels queued requests. */
+    private requestQueue;
+    private requestMap;
+    /** Pending arrival debounce or next-tick refill; only new arrivals replace this timer. */
+    private updateTimer;
+    constructor(props?: RequestSchedulerProps);
+    /**
+     * Update scheduler props. Preserves active and queued requests.
+     */
+    setProps(props: Omit<RequestSchedulerProps, 'id'>): void;
+    /**
+     * Called by an application that wants to issue a request, without having it deeply queued by the browser
+     *
+     * When the returned promise resolved, it is OK for the application to issue a request.
+     * The promise resolves to an object that contains a `done` method.
+     * When the application's request has completed (or failed), the application must call the `done` function
+     *
+     * @param handle
+     * @param getPriority will be called when request "slots" open up,
+     *    allowing the caller to update priority or cancel the request
+     *    Highest priority executes first, priority < 0 cancels the request
+     * @returns a promise
+     *   - resolves to a object (with a `done` field) when the request can be issued without queueing,
+     *   - resolves to `null` if the request has been cancelled (by the callback return < 0).
+     *     In this case the application should not issue the request
+     */
+    scheduleRequest(handle: Handle, getPriority?: GetPriorityFunction): Promise<RequestResult>;
+    _issueRequest(request: Request): Promise<any>;
+    /** Refills freed slots on the next tick while preserving any pending arrival debounce. */
+    private scheduleRefill;
+    /** Restarts the quiet period when a new request enters the queue. */
+    _issueNewRequests(): void;
+    /** Clears timer ownership before updating priorities and dispatching queued requests. */
+    _issueNewRequestsAsync(): void;
+    /** Ensure all requests have updated priorities, and that no longer valid requests are cancelled */
+    _updateAllRequests(): void;
+    /** Update a single request by calling the callback */
+    _updateRequest(request: any): boolean;
+}
+export {};
+//# sourceMappingURL=request-scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-scheduler.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/request-utils/request-scheduler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,KAAK,EAAC,MAAM,gBAAgB,CAAC;AAErC,KAAK,MAAM,GAAG,GAAG,CAAC;AAClB,KAAK,YAAY,GAAG,MAAM,GAAG,CAAC;AAC9B,KAAK,mBAAmB,GAAG,MAAM,MAAM,CAAC;AACxC,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,YAAY,CAAC;CACpB,GAAG,IAAI,CAAC;AAET,+BAA+B;AAC/B,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAqBF,yBAAyB;AACzB,KAAK,OAAO,GAAG;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAK;IAE/B,oFAAoF;IACpF,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,UAAU,CAAkD;IACpE,0FAA0F;IAC1F,OAAO,CAAC,WAAW,CAA8C;gBAErD,KAAK,GAAE,qBAA0B;IAY7C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC,GAAG,IAAI;IAYxD;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,mBAA6B,GACzC,OAAO,CAAC,aAAa,CAAC;IA0BzB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAsB7C,0FAA0F;IAC1F,OAAO,CAAC,cAAc;IAOtB,qEAAqE;IACrE,iBAAiB,IAAI,IAAI;IAOzB,yFAAyF;IACzF,sBAAsB;IA0BtB,mGAAmG;IACnG,kBAAkB;IAgBlB,sDAAsD;IACtD,cAAc,CAAC,OAAO,KAAA;CAUvB"}

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

@@ -0,0 +1,174 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { Stats } from 'probe.gl/stats';
+const STAT_QUEUED_REQUESTS = 'Queued Requests';
+const STAT_ACTIVE_REQUESTS = 'Active Requests';
+const STAT_CANCELLED_REQUESTS = 'Cancelled Requests';
+const STAT_QUEUED_REQUESTS_EVER = 'Queued Requests Ever';
+const STAT_ACTIVE_REQUESTS_EVER = 'Active Requests Ever';
+const DEFAULT_PROPS = {
+    id: 'request-scheduler',
+    /** Specifies if the request scheduler should throttle incoming requests, mainly for comparative testing. */
+    throttleRequests: true,
+    /** The maximum number of simultaneous active requests. Un-throttled requests do not observe this limit. */
+    maxRequests: 6,
+    /**
+     * Specifies a debounce time, in milliseconds. All requests are queued, until no new requests have
+     * been added to the queue for this amount of time.
+     */
+    debounceTime: 0
+};
+/**
+ * Used to issue a request, without having them "deeply queued" by the browser.
+ * @todo - Track requests globally, across multiple servers
+ */
+export default class RequestScheduler {
+    props;
+    stats;
+    activeRequestCount = 0;
+    /** Tracks the number of active requests and prioritizes/cancels queued requests. */
+    requestQueue = [];
+    requestMap = new Map();
+    /** Pending arrival debounce or next-tick refill; only new arrivals replace this timer. */
+    updateTimer = null;
+    constructor(props = {}) {
+        this.props = { ...DEFAULT_PROPS, ...props };
+        // Returns the statistics used by the request scheduler.
+        this.stats = new Stats({ id: this.props.id });
+        this.stats.get(STAT_QUEUED_REQUESTS);
+        this.stats.get(STAT_ACTIVE_REQUESTS);
+        this.stats.get(STAT_CANCELLED_REQUESTS);
+        this.stats.get(STAT_QUEUED_REQUESTS_EVER);
+        this.stats.get(STAT_ACTIVE_REQUESTS_EVER);
+    }
+    /**
+     * Update scheduler props. Preserves active and queued requests.
+     */
+    setProps(props) {
+        if (props.throttleRequests !== undefined) {
+            this.props.throttleRequests = props.throttleRequests;
+        }
+        if (props.maxRequests !== undefined) {
+            this.props.maxRequests = props.maxRequests;
+        }
+        if (props.debounceTime !== undefined) {
+            this.props.debounceTime = props.debounceTime;
+        }
+    }
+    /**
+     * Called by an application that wants to issue a request, without having it deeply queued by the browser
+     *
+     * When the returned promise resolved, it is OK for the application to issue a request.
+     * The promise resolves to an object that contains a `done` method.
+     * When the application's request has completed (or failed), the application must call the `done` function
+     *
+     * @param handle
+     * @param getPriority will be called when request "slots" open up,
+     *    allowing the caller to update priority or cancel the request
+     *    Highest priority executes first, priority < 0 cancels the request
+     * @returns a promise
+     *   - resolves to a object (with a `done` field) when the request can be issued without queueing,
+     *   - resolves to `null` if the request has been cancelled (by the callback return < 0).
+     *     In this case the application should not issue the request
+     */
+    scheduleRequest(handle, getPriority = () => 0) {
+        // Allows throttling to be disabled
+        if (!this.props.throttleRequests) {
+            return Promise.resolve({ done: () => { } });
+        }
+        // dedupe
+        if (this.requestMap.has(handle)) {
+            return this.requestMap.get(handle);
+        }
+        const request = { handle, priority: 0, getPriority };
+        const promise = new Promise(resolve => {
+            // @ts-ignore
+            request.resolve = resolve;
+            return request;
+        });
+        this.requestQueue.push(request);
+        this.requestMap.set(handle, promise);
+        this._issueNewRequests();
+        return promise;
+    }
+    // PRIVATE
+    _issueRequest(request) {
+        const { handle, resolve } = request;
+        let isDone = false;
+        const done = () => {
+            // can only be called once
+            if (!isDone) {
+                isDone = true;
+                // Stop tracking a request - it has completed, failed, cancelled etc
+                this.requestMap.delete(handle);
+                this.activeRequestCount--;
+                this.scheduleRefill();
+            }
+        };
+        // Track this request
+        this.activeRequestCount++;
+        return resolve ? resolve({ done }) : Promise.resolve({ done });
+    }
+    /** Refills freed slots on the next tick while preserving any pending arrival debounce. */
+    scheduleRefill() {
+        if (this.updateTimer !== null) {
+            return;
+        }
+        this.updateTimer = setTimeout(() => this._issueNewRequestsAsync(), 0);
+    }
+    /** Restarts the quiet period when a new request enters the queue. */
+    _issueNewRequests() {
+        if (this.updateTimer !== null) {
+            clearTimeout(this.updateTimer);
+        }
+        this.updateTimer = setTimeout(() => this._issueNewRequestsAsync(), this.props.debounceTime);
+    }
+    /** Clears timer ownership before updating priorities and dispatching queued requests. */
+    _issueNewRequestsAsync() {
+        if (this.updateTimer !== null) {
+            clearTimeout(this.updateTimer);
+        }
+        this.updateTimer = null;
+        const freeSlots = Math.max(this.props.maxRequests - this.activeRequestCount, 0);
+        if (freeSlots === 0) {
+            return;
+        }
+        this._updateAllRequests();
+        // Resolve pending promises for the top-priority requests
+        for (let i = 0; i < freeSlots; ++i) {
+            const request = this.requestQueue.shift();
+            if (request) {
+                this._issueRequest(request); // eslint-disable-line @typescript-eslint/no-floating-promises
+            }
+        }
+        // Uncomment to debug
+        // console.log(`${freeSlots} free slots, ${this.requestQueue.length} queued requests`);
+    }
+    /** Ensure all requests have updated priorities, and that no longer valid requests are cancelled */
+    _updateAllRequests() {
+        const requestQueue = this.requestQueue;
+        for (let i = 0; i < requestQueue.length; ++i) {
+            const request = requestQueue[i];
+            if (!this._updateRequest(request)) {
+                // Remove the element and make sure to adjust the counter to account for shortened array
+                requestQueue.splice(i, 1);
+                this.requestMap.delete(request.handle);
+                i--;
+            }
+        }
+        // Sort the remaining requests based on priority
+        requestQueue.sort((a, b) => a.priority - b.priority);
+    }
+    /** Update a single request by calling the callback */
+    _updateRequest(request) {
+        request.priority = request.getPriority(request.handle); // eslint-disable-line callback-return
+        // by returning a negative priority, the callback cancels the request
+        if (request.priority < 0) {
+            request.resolve(null);
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=request-scheduler.js.map