Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors
TypeScript a2aai-agentsai-gatewayanthropicclaudeclaude-codeclinecodexcopilotcursordeepseekfree-aigeminikimillm-gatewaymcpopenaiopenai-proxyqwentoken-saver
/**
* Anti-cheat system — server-side validation and anomaly detection.
*
* @module lib/gamification/antiCheat
*/
import { getDbInstance } from "../db/core";
// ─── Types ────────────────────────────────────────────────────────────────────
interface ScoreValidation {
allowed: boolean;
reason?: string;
}
interface AnomalyFlag {
apiKeyId: string;
xpLastHour: number;
zScore: number;
}
// ─── Statement / DB helpers (match gamification.ts pattern) ──────────────────
interface StatementLike<TRow = unknown> {
all: (...params: unknown[]) => TRow[];
get: (...params: unknown[]) => TRow | undefined;
run: (...params: unknown[]) => { changes: number };
}
interface DbLike {
prepare: <TRow = unknown>(sql: string) => StatementLike<TRow>;
}
function db(): DbLike {
return getDbInstance() as unknown as DbLike;
}
// ─── Constants ────────────────────────────────────────────────────────────────
const RATE_LIMIT_WINDOW_MS = 60_000; // 1 minute
const MAX_XP_PER_WINDOW = 1000;
const ANOMALY_Z_THRESHOLD = 3;
// ─── Public API ──────────────────────────────────────────────────────────────
/**
* Validate a score change. Returns true if allowed, false if suspicious.
*/
export async function validateScoreChange(
apiKeyId: string,
_action: string,
amount: number
): Promise<ScoreValidation> {
// A non-finite or negative amount would slip past (or offset) the window total.
if (!Number.isFinite(amount) || amount < 0) {
return { allowed: false, reason: "Invalid XP amount" };
}
// Rate limiting: max XP per window
const recentXp = await getRecentXp(apiKeyId, RATE_LIMIT_WINDOW_MS);
if (recentXp + amount > MAX_XP_PER_WINDOW) {
return {
allowed: false,
reason: `Rate limit exceeded: ${recentXp + amount} > ${MAX_XP_PER_WINDOW} XP/min`,
};
}
// Anomaly detection: check if this user's XP velocity is abnormal
const isAnomaly = await detectAnomaly(apiKeyId);
if (isAnomaly) {
return { allowed: false, reason: "Anomalous XP velocity detected" };
}
return { allowed: true };
}
/**
* Get flagged anomalies for admin review.
*/
export async function getAnomalies(): Promise<AnomalyFlag[]> {
const d = db();
const rows = d
.prepare(
`SELECT api_key_id, SUM(xp_earned) AS hourly_total
FROM xp_audit_log
WHERE created_at > datetime('now', '-1 hour')
GROUP BY api_key_id
HAVING hourly_total > 1000`
)
.all() as Array<{ api_key_id: string; hourly_total: number }>;
const results: AnomalyFlag[] = [];
for (const r of rows) {
const z = await computeZScore(r.api_key_id);
results.push({
apiKeyId: r.api_key_id,
xpLastHour: r.hourly_total,
zScore: z ?? 0,
});
}
return results;
}
// ─── Internal Helpers ────────────────────────────────────────────────────────
/**
* Compute the z-score for a user's hourly XP against the global distribution.
* Returns null if insufficient data.
*/
async function computeZScore(apiKeyId: string): Promise<number | null> {
const d = db();
const userRow = d
.prepare(
`SELECT COALESCE(SUM(xp_earned), 0) AS total
FROM xp_audit_log
WHERE api_key_id = ? AND created_at > datetime('now', '-1 hour')`
)
.get(apiKeyId) as { total: number };
const statsRow = d
.prepare(
`SELECT AVG(hourly_total) AS mean,
CASE WHEN AVG(hourly_total) = 0 THEN 1
ELSE AVG(hourly_total * hourly_total) - AVG(hourly_total) * AVG(hourly_total)
END AS variance
FROM (
SELECT api_key_id, SUM(xp_earned) AS hourly_total
FROM xp_audit_log
WHERE created_at > datetime('now', '-1 hour')
GROUP BY api_key_id
)`
)
.get() as { mean: number; variance: number } | undefined;
if (!statsRow || statsRow.variance <= 0) return null;
const stdDev = Math.sqrt(statsRow.variance);
return (userRow.total - statsRow.mean) / stdDev;
}
/**
* Get total XP earned in the last N milliseconds.
*/
async function getRecentXp(apiKeyId: string, windowMs: number): Promise<number> {
const d = db();
// xp_audit_log.created_at is written by the table default datetime('now') as
// "YYYY-MM-DD HH:MM:SS", and TEXT compares are lexical. Computing the window start in
// SQLite keeps both sides in the same format (an ISO "T…Z" string from JS never matched
// same-day rows, so the window read as empty).
const windowStart = `-${Math.ceil(windowMs / 1000)} seconds`;
const row = d
.prepare(
"SELECT COALESCE(SUM(xp_earned), 0) AS total FROM xp_audit_log WHERE api_key_id = ? AND created_at > datetime('now', ?)"
)
.get(apiKeyId, windowStart) as { total: number };
return row.total;
}
/**
* Detect anomalous XP velocity using z-score.
*/
async function detectAnomaly(apiKeyId: string): Promise<boolean> {
const z = await computeZScore(apiKeyId);
return z !== null && z > ANOMALY_Z_THRESHOLD;
}