Files
OmniRoute/tests/unit/usage-xai-split.test.ts
MumuTW f0b08f95c3 chore(usage): decompose services/usage.ts into per-provider usage/* leaves (999 → 253) (#8545)
* chore(usage): extract crof, nanogpt, qoder, opencode, deepseek, bailian, vertex, xiaomi-mimo, xai, github usage fetchers into usage/* leaves

Decompose services/usage.ts (god-file phase 1): move the remaining per-provider
usage fetcher/parser logic into co-located leaves under open-sse/services/usage/
so usage.ts becomes a thin dispatcher (imports + USAGE_FETCHER_PROVIDERS +
getUsageForProvider switch + __testing re-exports).

New leaves (each a pure data transform or independent fetcher, no orchestration):
  - usage/github.ts    getGitHubUsage, formatGitHubQuotaSnapshot, inferGitHubPlanName, shouldDisplayGitHubQuota
  - usage/crof.ts      getCrofUsage
  - usage/nanogpt.ts   getNanoGptUsage
  - usage/qoder.ts     getQoderUsage, parseQoderUserStatusUsage
  - usage/opencode.ts  getOpencodeUsage
  - usage/deepseek.ts  getDeepseekUsage
  - usage/bailian.ts   getBailianCodingPlanUsage
  - usage/vertex.ts    getVertexUsage
  - usage/xiaomi-mimo.ts getXiaomiMimoUsage
  - usage/xai.ts       getXaiUsage

usage.ts re-exports parseQoderUserStatusUsage (named) and threads every helper
the existing __testing contract exposes (usage-utils / usage-service-hardening /
qoder-usage-quota / xiaomi-mimo-selftrack / xai-usage / vertex-spend suites read
them from services/usage). External importers unchanged.

open-sse/services/usage.ts: 1065 -> 256 lines (cap 800).
npm run check:file-size: OK. typecheck:core: OK. eslint: clean. check:cycles: OK.

Added characterization tests (tests/unit/usage-<provider>-split.test.ts) that
import each leaf directly and pin its export surface + key edges, mirroring the
existing usage-quota-core-split / usage-scalars-split pattern.

* docs(changelog): add fragment for this PR
2026-07-26 03:52:19 -03:00

73 lines
2.5 KiB
TypeScript

// Characterization of the services/usage.ts xai split (god-file decomposition): the xAI (Grok)
// self-tracked cumulative usage fetcher (getXaiUsage) moved into services/usage/xai.ts so
// usage.ts stays a thin dispatcher. Behavior-preserving move — this locks the export surface and
// the missing-connection-id fail-open; the cumulative unlimited shaping is covered via
// __testing.getXaiUsage in xai-usage.test.ts.
import { describe, it, before, after } from "node:test";
import assert from "node:assert/strict";
import os from "node:os";
import path from "node:path";
import fs from "node:fs";
// DATA_DIR must be set before any module that opens the DB is imported.
const TMP = fs.mkdtempSync(path.join(os.tmpdir(), "omni-xai-split-"));
process.env.DATA_DIR = TMP;
const core = await import("../../src/lib/db/core.ts");
const X = await import("../../open-sse/services/usage/xai.ts");
function insertUsage(
connectionId: string,
provider: string,
tokensIn: number,
tokensOut: number,
timestamp: string
) {
const db = core.getDbInstance();
db.prepare(
`INSERT INTO usage_history (provider, connection_id, tokens_input, tokens_output, timestamp)
VALUES (?, ?, ?, ?, ?)`
).run(provider, connectionId, tokensIn, tokensOut, timestamp);
}
describe("xai leaf self-tracked usage", () => {
before(() => {
core.getDbInstance(); // trigger migrations
insertUsage("conn-leaf", "xai", 2_000_000, 300_000, new Date().toISOString());
});
after(() => {
core.resetDbInstance();
try {
fs.rmSync(TMP, { recursive: true, force: true });
} catch {
// best-effort temp cleanup
}
});
it("module exposes getXaiUsage", () => {
assert.equal(typeof X.getXaiUsage, "function");
});
it("returns a message when connection id is missing", async () => {
const r = (await X.getXaiUsage("")) as { message?: string; quotas?: unknown };
assert.ok(r.message && !r.quotas, "no quota without a connection id");
});
it("returns a cumulative unlimited quota scoped to the connection", async () => {
const r = (await X.getXaiUsage("conn-leaf")) as {
plan?: string;
quotas?: Record<
string,
{ used: number; total: number; remaining: number; unlimited: boolean }
>;
message?: string;
};
assert.ok(r.quotas, `expected quotas, got message: ${r.message}`);
const m = r.quotas!.monthly;
assert.equal(m.used, 2_300_000);
assert.equal(m.unlimited, true, "xAI has no fixed monthly cap");
assert.equal(m.remaining, 100, "unlimited rows report remaining: 100");
});
});