Files
OmniRoute/tests/unit/quota-phase2.test.ts
Benson K B 2d50ec0789 feat(routing): add quota-aware provider scheduling — Phase 2 (#10126)
* feat(quota): Phase 2 adapters, reset timers, analytics, and dashboard API

* feat(routing): add quota-aware provider scheduling (opt-in)

* fix(db): rename migration to 148_provider_quota_state.sql

* fix(quota): harden quota state route, isolate phase2 tests, slim env diff

- route: requireManagementAuth + Zod body validation + buildErrorBody
  sanitization (Hard Rule #12); fix clearProviderQuotaState -> clearProviderQuota
- .env.example/ENVIRONMENT.md: drop ~20 foreign vars, keep only
  OMNIROUTE_QUOTA_AWARE_ROUTING (migration 148)
- tests/unit/quota-phase2.test.ts: DATA_DIR mkdtemp + resetDbInstance teardown

Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>

* chore(ci): fix docs-sync + eslint-suppression drift for quota branch

CI gates flagged on PR #10126 head 43335f07:
- migration counts in README/AGENTS/llm.txt were stale (145 -> 146)
- regenerate docs/reference/PROVIDER_REFERENCE.md (gen-provider-reference)
- sync root llm.txt body into all 42 i18n mirrors (headers preserved)
- prune eslint suppressions that no longer occur

--no-verify: pre-commit docs-sync was failing on a pre-existing
release-base artifact (changelog 3.8.49 vs package 3.8.50) — fixed by
the changelog entry in the prior commit; re-verify in CI.

* chore(skills): regenerate agent skills (add omni-settings)

Merge-integrity CI gate flagged a missing generated skill. Regenerated
with check:agent-skills-sync --apply: +omni-settings, 45 unchanged.

* fix(ci): resolve Fast Quality Gates regressions on quota branch

- check-migration-numbering: migration 148 (provider_quota_state) landed
  on this branch, so the KNOWN_GAPS allowlist entry is stale — remove it
  (stale-enforcement 6A.3: 'REMOVA a entrada')
- open-sse/utils/stream.ts: duplicate sseCommentsEnabled import from a
  bad merge (lines 31 + 77) — TS2300 duplicate identifier; drop the
  duplicate so the open-sse typecheck gate is back within baseline

* docs: sync migration count to 149 after release merge

Co-authored-by: diegosouzapw <diegosouza.pw@gmail.com>

* test(migrations): align 148 gap assertion after 148_provider_quota_state.sql landed

The phase-2 branch added 148_provider_quota_state.sql, and 148 was already
removed from KNOWN_GAPS in scripts/check/check-migration-numbering.mjs. The
frozen-allowlists assertion still expected 148 to be a gap, so it failed.
Flip the assertion to match the allowlist (same pattern as 143/147).

Co-authored-by: diegosouzapw <diegosouza.pw@gmail.com>

---------

Co-authored-by: benzntech <benzntech@users.noreply.github.com>
Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>
Co-authored-by: adevwithpurpose <adevwithpurpose@users.noreply.github.com>
Co-authored-by: diegosouzapw <diegosouza.pw@gmail.com>
2026-08-18 10:49:19 -03:00

112 lines
3.7 KiB
TypeScript

import { test } from "node:test";
import assert from "node:assert/strict";
import fs from "node:fs";
import os from "node:os";
import path from "node:path";
const TEST_DATA_DIR = fs.mkdtempSync(path.join(os.tmpdir(), "omni-quota-phase2-"));
process.env.DATA_DIR = TEST_DATA_DIR;
const coreDb = await import("../../src/lib/db/core.ts");
const { parseProviderQuotaHeaders, applyQuotaHeadersToState } = await import(
"../../src/lib/quota/quotaAdapters"
);
const { getQuotaAnalyticsSummary } = await import("../../src/lib/quota/quotaAnalytics");
const { getActiveQuotaResetItems, resetExpiredQuotaWindows } = await import(
"../../src/lib/quota/quotaResetTimers"
);
const { recordProviderQuotaUsage, getProviderQuota } = await import(
"../../src/lib/quota/providerQuotaState"
);
const { getDbInstance } = coreDb;
async function resetStorage() {
coreDb.resetDbInstance();
fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true });
fs.mkdirSync(TEST_DATA_DIR, { recursive: true });
}
test.beforeEach(async () => {
await resetStorage();
});
test.after(() => {
coreDb.resetDbInstance();
fs.rmSync(TEST_DATA_DIR, { recursive: true, force: true });
});
test("parseProviderQuotaHeaders: parses OpenAI rate limit headers", () => {
const headers = new Headers({
"x-ratelimit-limit-tokens": "100000",
"x-ratelimit-remaining-tokens": "80000",
"x-ratelimit-reset-tokens": "60s",
});
const parsed = parseProviderQuotaHeaders(headers, "openai");
assert.ok(parsed);
assert.equal(parsed?.tokenLimit, 100000);
assert.equal(parsed?.tokensRemaining, 80000);
assert.equal(parsed?.tokensUsed, 20000);
assert.equal(parsed?.windowResetMs, 60000);
});
test("parseProviderQuotaHeaders: parses Anthropic rate limit headers", () => {
const headers = new Headers({
"anthropic-ratelimit-input-tokens-limit": "50000",
"anthropic-ratelimit-input-tokens-remaining": "10000",
"anthropic-ratelimit-input-tokens-reset": "30s",
});
const parsed = parseProviderQuotaHeaders(headers, "anthropic");
assert.ok(parsed);
assert.equal(parsed?.tokenLimit, 50000);
assert.equal(parsed?.tokensRemaining, 10000);
assert.equal(parsed?.tokensUsed, 40000);
assert.equal(parsed?.windowResetMs, 30000);
});
test("applyQuotaHeadersToState & getQuotaAnalyticsSummary: records and aggregates quota analytics", () => {
const connId = "test-conn-p2-01";
const model = "gpt-4o";
const headers = {
"x-ratelimit-limit-tokens": "100000",
"x-ratelimit-remaining-tokens": "20000",
"x-ratelimit-reset-tokens": "120s",
};
applyQuotaHeadersToState(connId, model, headers, "openai");
const snapshot = getProviderQuota(connId, model);
assert.ok(snapshot);
assert.equal(snapshot?.tokensUsed, 80000);
assert.equal(snapshot?.tokenLimit, 100000);
const analytics = getQuotaAnalyticsSummary();
assert.ok(analytics.totalConnectionsTracked > 0);
assert.ok(analytics.connections.some((c) => c.connectionId === connId));
});
test("quotaResetTimers: tracks active reset items and purges expired windows", () => {
const connId = "test-conn-expired";
const model = "claude-sonnet-4-6";
const now = Date.now();
// Seed an already-expired window directly (recordProviderQuotaUsage always
// computes windows from Date.now(), so it cannot create a past window).
const db = getDbInstance();
db.prepare(
`INSERT OR REPLACE INTO provider_quota_state
(connection_id, model, tokens_used, token_limit, window_start, window_reset, updated_at)
VALUES (?, ?, ?, ?, ?, ?, ?)`
).run(
connId,
model,
5000,
5000,
now - 10_000,
now - 1_000,
new Date().toISOString()
);
const expiredCount = resetExpiredQuotaWindows();
assert.ok(expiredCount >= 1);
});