mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-08-22 15:12:23 +03:00
c09978454b
T-19 — Domain Layer: - modelAvailability.js: Model availability tracking with TTL cooldowns - costRules.js: Per-API-key budget management with daily/monthly limits - fallbackPolicy.js: Declarative fallback chain routing T-22 — Error Codes Catalog: - errorCodes.js: 24 codes in 6 categories + createErrorResponse helper T-23 — Correlation ID: - requestId.js: AsyncLocalStorage-based x-request-id propagation T-25 — Fetch Timeout: - fetchTimeout.js: AbortController wrapper with FETCH_TIMEOUT_MS env var T-27 — JSDoc + @ts-check: - Added @ts-check to 8 critical files TASKS.md updated: 37/46 tasks Concluído, 9 remaining Tests: 119/119 pass (88 existing + 31 new)
109 lines
2.8 KiB
JavaScript
109 lines
2.8 KiB
JavaScript
/**
|
|
* Fallback Policy — Domain Layer (T-19)
|
|
*
|
|
* Declarative fallback chain for model routing.
|
|
* When a primary provider is unavailable, the policy engine
|
|
* resolves to alternative providers in priority order.
|
|
*
|
|
* @module domain/fallbackPolicy
|
|
*/
|
|
|
|
// @ts-check
|
|
|
|
/**
|
|
* @typedef {Object} FallbackEntry
|
|
* @property {string} provider - Provider ID
|
|
* @property {number} [priority=0] - Lower = higher priority
|
|
* @property {boolean} [enabled=true] - Whether this fallback is active
|
|
*/
|
|
|
|
/** @type {Map<string, FallbackEntry[]>} model → fallback chain */
|
|
const fallbackChains = new Map();
|
|
|
|
/**
|
|
* Register a fallback chain for a model.
|
|
*
|
|
* @param {string} model - Model identifier (e.g. "gpt-4o")
|
|
* @param {FallbackEntry[]} chain - Ordered list of fallback providers
|
|
*/
|
|
export function registerFallback(model, chain) {
|
|
const sorted = [...chain]
|
|
.map((e) => ({
|
|
provider: e.provider,
|
|
priority: e.priority ?? 0,
|
|
enabled: e.enabled ?? true,
|
|
}))
|
|
.sort((a, b) => a.priority - b.priority);
|
|
|
|
fallbackChains.set(model, sorted);
|
|
}
|
|
|
|
/**
|
|
* Resolve the fallback chain for a model.
|
|
* Returns only enabled providers, sorted by priority.
|
|
*
|
|
* @param {string} model
|
|
* @param {string[]} [excludeProviders=[]] - Providers to skip (e.g. already tried)
|
|
* @returns {FallbackEntry[]} Ordered list of fallback providers
|
|
*/
|
|
export function resolveFallbackChain(model, excludeProviders = []) {
|
|
const chain = fallbackChains.get(model);
|
|
if (!chain) return [];
|
|
|
|
const excludeSet = new Set(excludeProviders);
|
|
return chain.filter((e) => e.enabled && !excludeSet.has(e.provider));
|
|
}
|
|
|
|
/**
|
|
* Get the next provider in the fallback chain.
|
|
*
|
|
* @param {string} model
|
|
* @param {string[]} [excludeProviders=[]]
|
|
* @returns {string | null} Next provider ID or null if chain exhausted
|
|
*/
|
|
export function getNextFallback(model, excludeProviders = []) {
|
|
const chain = resolveFallbackChain(model, excludeProviders);
|
|
return chain.length > 0 ? chain[0].provider : null;
|
|
}
|
|
|
|
/**
|
|
* Check if a model has any fallback providers configured.
|
|
*
|
|
* @param {string} model
|
|
* @returns {boolean}
|
|
*/
|
|
export function hasFallback(model) {
|
|
const chain = fallbackChains.get(model);
|
|
return !!chain && chain.some((e) => e.enabled);
|
|
}
|
|
|
|
/**
|
|
* Remove a fallback chain for a model.
|
|
*
|
|
* @param {string} model
|
|
* @returns {boolean} true if removed
|
|
*/
|
|
export function removeFallback(model) {
|
|
return fallbackChains.delete(model);
|
|
}
|
|
|
|
/**
|
|
* Get all registered fallback chains (for dashboard).
|
|
*
|
|
* @returns {Record<string, FallbackEntry[]>}
|
|
*/
|
|
export function getAllFallbackChains() {
|
|
const result = {};
|
|
for (const [model, chain] of fallbackChains.entries()) {
|
|
result[model] = chain;
|
|
}
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Reset all fallback chains (for testing).
|
|
*/
|
|
export function resetAllFallbacks() {
|
|
fallbackChains.clear();
|
|
}
|