@media-engine/core 0.1.0 → 0.1.1

package/dist/engine/circuit-breaker.d.ts

@@ -0,0 +1,36 @@
+import type { CircuitBreakerOptions } from "./types.js";
+interface ProviderFailureCounts {
+    timeout: number;
+    rateLimited: number;
+    unavailable: number;
+    other: number;
+}
+export interface CircuitBreakerSnapshot {
+    state: "closed" | "open" | "half-open";
+    consecutiveFailures: number;
+    totalRequests: number;
+    totalSuccesses: number;
+    totalFailures: number;
+    lastSuccessAt?: number;
+    lastFailureAt?: number;
+    lastFailureCode?: string;
+    failureCounts: ProviderFailureCounts;
+    retryAfterMs?: number;
+}
+export declare class ProviderCircuitBreaker {
+    private readonly failureThreshold;
+    private readonly recoveryTimeoutMs;
+    private readonly now;
+    private readonly states;
+    private readonly observations;
+    constructor(options?: CircuitBreakerOptions, now?: () => number);
+    run<T>(key: string, provider: string, operation: () => Promise<T>): Promise<T>;
+    getSnapshot(key: string): CircuitBreakerSnapshot;
+    private acquire;
+    private recordFailure;
+    private recordRequest;
+    private recordSuccess;
+    private recordObservedFailure;
+    private getObservation;
+}
+export {};

package/dist/engine/circuit-breaker.js

@@ -0,0 +1,163 @@
+import { ProviderError } from "../errors/index.js";
+const DEFAULT_FAILURE_THRESHOLD = 3;
+const DEFAULT_RECOVERY_TIMEOUT_MS = 30_000;
+// Tracks transient provider failures and allows one recovery probe after cooldown.
+// Отслеживает временные сбои провайдера и разрешает одну пробу после cooldown.
+export class ProviderCircuitBreaker {
+    failureThreshold;
+    recoveryTimeoutMs;
+    now;
+    states = new Map();
+    observations = new Map();
+    constructor(options = {}, now = Date.now) {
+        this.failureThreshold = validatePositiveInteger(options.failureThreshold, DEFAULT_FAILURE_THRESHOLD, "failureThreshold");
+        this.recoveryTimeoutMs = validateNonNegativeInteger(options.recoveryTimeoutMs, DEFAULT_RECOVERY_TIMEOUT_MS, "recoveryTimeoutMs");
+        this.now = now;
+    }
+    async run(key, provider, operation) {
+        this.acquire(key, provider);
+        this.recordRequest(key);
+        try {
+            const result = await operation();
+            this.states.delete(key);
+            this.recordSuccess(key);
+            return result;
+        }
+        catch (error) {
+            this.recordFailure(key, error);
+            this.recordObservedFailure(key, error);
+            throw error;
+        }
+    }
+    getSnapshot(key) {
+        const now = this.now();
+        const state = this.states.get(key);
+        const observation = this.observations.get(key);
+        const circuitState = state?.probeInFlight
+            ? "half-open"
+            : state?.openedAt !== undefined
+                ? "open"
+                : "closed";
+        const retryAfterMs = state?.openedAt === undefined
+            ? undefined
+            : Math.max(0, this.recoveryTimeoutMs - (now - state.openedAt));
+        return {
+            state: circuitState,
+            consecutiveFailures: state?.failures ?? 0,
+            totalRequests: observation?.totalRequests ?? 0,
+            totalSuccesses: observation?.totalSuccesses ?? 0,
+            totalFailures: observation?.totalFailures ?? 0,
+            lastSuccessAt: observation?.lastSuccessAt,
+            lastFailureAt: observation?.lastFailureAt,
+            lastFailureCode: observation?.lastFailureCode,
+            failureCounts: observation?.failureCounts ?? createEmptyFailureCounts(),
+            retryAfterMs,
+        };
+    }
+    acquire(key, provider) {
+        const state = this.states.get(key);
+        if (state?.openedAt === undefined) {
+            return;
+        }
+        if (this.now() - state.openedAt < this.recoveryTimeoutMs || state.probeInFlight) {
+            throw createOpenCircuitError(provider);
+        }
+        state.probeInFlight = true;
+    }
+    recordFailure(key, error) {
+        const state = this.states.get(key);
+        if (!(error instanceof ProviderError) || !error.retryable) {
+            this.states.delete(key);
+            return;
+        }
+        if (state?.probeInFlight) {
+            this.states.set(key, {
+                failures: this.failureThreshold,
+                openedAt: this.now(),
+                probeInFlight: false,
+            });
+            return;
+        }
+        const failures = (state?.failures ?? 0) + 1;
+        this.states.set(key, {
+            failures,
+            openedAt: failures >= this.failureThreshold ? this.now() : undefined,
+            probeInFlight: false,
+        });
+    }
+    recordRequest(key) {
+        const observation = this.getObservation(key);
+        observation.totalRequests += 1;
+    }
+    recordSuccess(key) {
+        const observation = this.getObservation(key);
+        observation.totalSuccesses += 1;
+        observation.lastSuccessAt = this.now();
+    }
+    recordObservedFailure(key, error) {
+        const observation = this.getObservation(key);
+        observation.totalFailures += 1;
+        observation.lastFailureAt = this.now();
+        observation.lastFailureCode = error instanceof ProviderError ? error.code : "PROVIDER_ERROR";
+        if (!(error instanceof ProviderError)) {
+            observation.failureCounts.other += 1;
+        }
+        else if (error.code === "PROVIDER_TIMEOUT") {
+            observation.failureCounts.timeout += 1;
+        }
+        else if (error.code === "PROVIDER_RATE_LIMITED") {
+            observation.failureCounts.rateLimited += 1;
+        }
+        else if (error.code === "PROVIDER_UNAVAILABLE") {
+            observation.failureCounts.unavailable += 1;
+        }
+        else {
+            observation.failureCounts.other += 1;
+        }
+    }
+    getObservation(key) {
+        const existing = this.observations.get(key);
+        if (existing) {
+            return existing;
+        }
+        const observation = {
+            totalRequests: 0,
+            totalSuccesses: 0,
+            totalFailures: 0,
+            failureCounts: createEmptyFailureCounts(),
+        };
+        this.observations.set(key, observation);
+        return observation;
+    }
+}
+function createEmptyFailureCounts() {
+    return {
+        timeout: 0,
+        rateLimited: 0,
+        unavailable: 0,
+        other: 0,
+    };
+}
+function createOpenCircuitError(provider) {
+    return new ProviderError({
+        provider,
+        code: "PROVIDER_UNAVAILABLE",
+        message: `Provider "${provider}" circuit is open after repeated failures.`,
+        retryable: true,
+    });
+}
+function validatePositiveInteger(value, fallback, name) {
+    const normalized = value ?? fallback;
+    if (!Number.isSafeInteger(normalized) || normalized <= 0) {
+        throw new TypeError(`Circuit breaker ${name} must be a positive integer.`);
+    }
+    return normalized;
+}
+function validateNonNegativeInteger(value, fallback, name) {
+    const normalized = value ?? fallback;
+    if (!Number.isSafeInteger(normalized) || normalized < 0) {
+        throw new TypeError(`Circuit breaker ${name} must be a non-negative integer.`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/engine/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/engine/circuit-breaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,yBAAyB,GAAG,CAAC,CAAC;AACpC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAsC3C,mFAAmF;AACnF,+EAA+E;AAC/E,MAAM,OAAO,sBAAsB;IAChB,gBAAgB,CAAS;IACzB,iBAAiB,CAAS;IAC1B,GAAG,CAAe;IAClB,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IACzC,YAAY,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEvE,YAAY,UAAiC,EAAE,EAAE,MAAoB,IAAI,CAAC,GAAG;QAC3E,IAAI,CAAC,gBAAgB,GAAG,uBAAuB,CAC7C,OAAO,CAAC,gBAAgB,EACxB,yBAAyB,EACzB,kBAAkB,CACnB,CAAC;QACF,IAAI,CAAC,iBAAiB,GAAG,0BAA0B,CACjD,OAAO,CAAC,iBAAiB,EACzB,2BAA2B,EAC3B,mBAAmB,CACpB,CAAC;QACF,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,QAAgB,EAAE,SAA2B;QACrE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAExB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,WAAW,CAAC,GAAW;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,KAAK,EAAE,aAAa;YACvC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,SAAS;gBAC7B,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,QAAQ,CAAC;QACf,MAAM,YAAY,GAChB,KAAK,EAAE,QAAQ,KAAK,SAAS;YAC3B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEnE,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,mBAAmB,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC;YACzC,aAAa,EAAE,WAAW,EAAE,aAAa,IAAI,CAAC;YAC9C,cAAc,EAAE,WAAW,EAAE,cAAc,IAAI,CAAC;YAChD,aAAa,EAAE,WAAW,EAAE,aAAa,IAAI,CAAC;YAC9C,aAAa,EAAE,WAAW,EAAE,aAAa;YACzC,aAAa,EAAE,WAAW,EAAE,aAAa;YACzC,eAAe,EAAE,WAAW,EAAE,eAAe;YAC7C,aAAa,EAAE,WAAW,EAAE,aAAa,IAAI,wBAAwB,EAAE;YACvE,YAAY;SACb,CAAC;IACJ,CAAC;IAEO,OAAO,CAAC,GAAW,EAAE,QAAgB;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEnC,IAAI,KAAK,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,iBAAiB,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YAChF,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QAED,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IAC7B,CAAC;IAEO,aAAa,CAAC,GAAW,EAAE,KAAc;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEnC,IAAI,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAC1D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,KAAK,EAAE,aAAa,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;gBACnB,QAAQ,EAAE,IAAI,CAAC,gBAAgB;gBAC/B,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;gBACpB,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;YACnB,QAAQ;YACR,QAAQ,EAAE,QAAQ,IAAI,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;YACpE,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,GAAW;QAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7C,WAAW,CAAC,aAAa,IAAI,CAAC,CAAC;IACjC,CAAC;IAEO,aAAa,CAAC,GAAW;QAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7C,WAAW,CAAC,cAAc,IAAI,CAAC,CAAC;QAChC,WAAW,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;IAEO,qBAAqB,CAAC,GAAW,EAAE,KAAc;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7C,WAAW,CAAC,aAAa,IAAI,CAAC,CAAC;QAC/B,WAAW,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,WAAW,CAAC,eAAe,GAAG,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAE7F,IAAI,CAAC,CAAC,KAAK,YAAY,aAAa,CAAC,EAAE,CAAC;YACtC,WAAW,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAC7C,WAAW,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;YAClD,WAAW,CAAC,aAAa,CAAC,WAAW,IAAI,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACjD,WAAW,CAAC,aAAa,CAAC,WAAW,IAAI,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,GAAW;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,WAAW,GAAwB;YACvC,aAAa,EAAE,CAAC;YAChB,cAAc,EAAE,CAAC;YACjB,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,wBAAwB,EAAE;SAC1C,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACxC,OAAO,WAAW,CAAC;IACrB,CAAC;CACF;AAED,SAAS,wBAAwB;IAC/B,OAAO;QACL,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;QACd,KAAK,EAAE,CAAC;KACT,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,OAAO,IAAI,aAAa,CAAC;QACvB,QAAQ;QACR,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,aAAa,QAAQ,4CAA4C;QAC1E,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAyB,EACzB,QAAgB,EAChB,IAAY;IAEZ,MAAM,UAAU,GAAG,KAAK,IAAI,QAAQ,CAAC;IAErC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,SAAS,CAAC,mBAAmB,IAAI,8BAA8B,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,0BAA0B,CACjC,KAAyB,EACzB,QAAgB,EAChB,IAAY;IAEZ,MAAM,UAAU,GAAG,KAAK,IAAI,QAAQ,CAAC;IAErC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,SAAS,CAAC,mBAAmB,IAAI,kCAAkC,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/engine/concurrency-limiter.d.ts

@@ -0,0 +1,13 @@
+import type { ProviderConcurrencyOptions } from "./types.js";
+export declare class ProviderConcurrencyLimiter {
+    private readonly defaultMaxConcurrent;
+    private readonly maxQueueSize;
+    private readonly providerLimits;
+    private readonly queues;
+    constructor(options?: ProviderConcurrencyOptions);
+    run<T>(key: string, provider: string, signal: AbortSignal | undefined, operation: () => Promise<T>): Promise<T>;
+    private getQueue;
+    private execute;
+    private drain;
+    private deleteIdleQueue;
+}

package/dist/engine/concurrency-limiter.js

@@ -0,0 +1,109 @@
+import { ProviderError } from "../errors/index.js";
+const DEFAULT_MAX_CONCURRENT = 2;
+const DEFAULT_MAX_QUEUE_SIZE = 100;
+const MAX_CONCURRENT_BOUND = 100;
+const MAX_QUEUE_SIZE_BOUND = 10_000;
+// Bounds concurrent work independently for every metadata or streaming provider.
+// Ограничивает параллельную работу отдельно для каждого metadata/streaming-провайдера.
+export class ProviderConcurrencyLimiter {
+    defaultMaxConcurrent;
+    maxQueueSize;
+    providerLimits;
+    queues = new Map();
+    constructor(options = {}) {
+        this.defaultMaxConcurrent = validateBoundedInteger(options.defaultMaxConcurrent, DEFAULT_MAX_CONCURRENT, 1, MAX_CONCURRENT_BOUND, "defaultMaxConcurrent");
+        this.maxQueueSize = validateBoundedInteger(options.maxQueueSize, DEFAULT_MAX_QUEUE_SIZE, 0, MAX_QUEUE_SIZE_BOUND, "maxQueueSize");
+        this.providerLimits = new Map(Object.entries(options.providerLimits ?? {}).map(([provider, limit]) => [
+            validateProviderName(provider),
+            validateBoundedInteger(limit, this.defaultMaxConcurrent, 1, MAX_CONCURRENT_BOUND, `providerLimits.${provider}`),
+        ]));
+    }
+    run(key, provider, signal, operation) {
+        if (signal?.aborted) {
+            return Promise.reject(signal.reason);
+        }
+        const queue = this.getQueue(key);
+        const limit = this.providerLimits.get(provider) ?? this.defaultMaxConcurrent;
+        if (queue.active < limit) {
+            return this.execute(key, queue, provider, operation);
+        }
+        if (queue.waiting.length >= this.maxQueueSize) {
+            return Promise.reject(createSaturatedError(provider));
+        }
+        return new Promise((resolve, reject) => {
+            const entry = { provider, operation, resolve, reject, signal };
+            if (signal) {
+                entry.onAbort = () => {
+                    const index = queue.waiting.indexOf(entry);
+                    if (index !== -1) {
+                        queue.waiting.splice(index, 1);
+                        reject(signal.reason);
+                        this.deleteIdleQueue(key, queue);
+                    }
+                };
+                signal.addEventListener("abort", entry.onAbort, { once: true });
+            }
+            queue.waiting.push(entry);
+        });
+    }
+    getQueue(key) {
+        const existing = this.queues.get(key);
+        if (existing) {
+            return existing;
+        }
+        const queue = { active: 0, waiting: [] };
+        this.queues.set(key, queue);
+        return queue;
+    }
+    async execute(key, queue, provider, operation) {
+        queue.active += 1;
+        try {
+            return await operation();
+        }
+        finally {
+            queue.active -= 1;
+            this.drain(key, queue, provider);
+        }
+    }
+    drain(key, queue, provider) {
+        const limit = this.providerLimits.get(provider) ?? this.defaultMaxConcurrent;
+        while (queue.active < limit) {
+            const next = queue.waiting.shift();
+            if (!next) {
+                break;
+            }
+            if (next.onAbort && next.signal) {
+                next.signal.removeEventListener("abort", next.onAbort);
+            }
+            void this.execute(key, queue, next.provider, next.operation).then(next.resolve, next.reject);
+        }
+        this.deleteIdleQueue(key, queue);
+    }
+    deleteIdleQueue(key, queue) {
+        if (queue.active === 0 && queue.waiting.length === 0) {
+            this.queues.delete(key);
+        }
+    }
+}
+function createSaturatedError(provider) {
+    return new ProviderError({
+        provider,
+        code: "PROVIDER_UNAVAILABLE",
+        message: `Provider "${provider}" concurrency queue is full.`,
+        retryable: true,
+    });
+}
+function validateProviderName(provider) {
+    if (!provider || provider.trim() !== provider) {
+        throw new TypeError("Provider concurrency override names must be non-empty and unpadded.");
+    }
+    return provider;
+}
+function validateBoundedInteger(value, fallback, minimum, maximum, name) {
+    const normalized = value ?? fallback;
+    if (!Number.isSafeInteger(normalized) || normalized < minimum || normalized > maximum) {
+        throw new TypeError(`Provider concurrency ${name} must be an integer between ${minimum} and ${maximum}.`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=concurrency-limiter.js.map

package/dist/engine/concurrency-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency-limiter.js","sourceRoot":"","sources":["../../src/engine/concurrency-limiter.ts"],"names":[],"mappings":"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"}

package/dist/engine/engine.d.ts

@@ -4,7 +4,7 @@ import { type MergeStrategy } from "../merge/index.js";
 import { ProviderRegistry, type ProviderInfo } from "../providers/index.js";
 import type { SearchQuery, SearchResponse } from "../search/index.js";
 import type { MediaAvailability, StreamQuery, StreamingProviderInfo } from "../streaming/index.js";
-import type { MediaEngineOptions } from "./types.js";
+import type { MediaEngineOptions, ProviderHealthStatus } from "./types.js";
 export declare class MediaEngine {
     private readonly registry;
     private readonly streamingProviders;
@@ -13,9 +13,13 @@ export declare class MediaEngine {
     private readonly timeoutMs?;
     private readonly providerTimeouts;
     private readonly debug;
+    private readonly circuitBreaker?;
+    private readonly concurrencyLimiter?;
+    private readonly inFlightRequests;
     constructor(options?: MediaEngineOptions);
     getProviders(): ProviderInfo[];
     getStreamingProviders(): StreamingProviderInfo[];
+    getProviderHealth(): ProviderHealthStatus[];
     search(query: SearchQuery): Promise<SearchResponse>;
     getDetails(query: DetailsQuery): Promise<DetailsResponse>;
     getAvailability(query: StreamQuery): Promise<MediaAvailability>;
@@ -24,6 +28,7 @@ export declare class MediaEngine {
     protected get engineMergeStrategy(): MergeStrategy;
     protected get engineTimeoutMs(): number | undefined;
     private getProviderTimeoutMs;
-    private loadSearchPoster;
+    private createProviderTimeoutBudget;
+    private createProviderHealthStatus;
     protected get engineDebug(): boolean;
 }