This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
caelum0x 49b183818c Unify gitgram + aitimemachine into the monorepo (de-submodule) and merge vendored engines
Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as
opaque submodule gitlinks on GitHub) into fully-tracked first-party content.

AITM now merges its 7 vendored repos as first-party engines:
- memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts
- git: vendored C git (bundled binary) + gitnexus (in-process code intelligence)
- agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess)

Includes the full session's product build: Gitgram web/mobile/backend features,
AITM website/CLI/MCP, the unified memory layer, engine build tooling
(scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md),
and extensive test suites.

Build artifacts, node_modules, external/, and gemini-cli are gitignored.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 14:14:09 +03:00

195 lines
7.6 KiB
TypeScript

/**
* Integration Tests: Usage Routes
*
* Tests the /v1/usage endpoints:
* - GET /v1/usage - Current period usage summary
* - GET /v1/usage/history - Historical usage data
* - GET /v1/usage/breakdown - Breakdown by resource type
* - GET /v1/usage/limits - Plan limits and percentages
*/
import { describe, it, expect, beforeAll, beforeEach } from "vitest";
import request from "supertest";
import type { Express } from "express";
import { seedTestData, createTestApp, TEST_API_KEY } from "../setup.js";
let app: Express;
beforeAll(async () => {
app = await createTestApp();
});
beforeEach(() => {
seedTestData();
});
describe("Usage API - /v1/usage", () => {
// ==========================================================================
// GET /v1/usage - Current period summary
// ==========================================================================
describe("GET /v1/usage", () => {
it("should return usage summary with correct structure", async () => {
const res = await request(app)
.get("/v1/usage")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("period");
expect(res.body).toHaveProperty("checkpoints");
expect(res.body).toHaveProperty("repositories");
expect(res.body).toHaveProperty("contexts");
expect(res.body).toHaveProperty("api_calls");
expect(res.body).toHaveProperty("limits");
});
it("should require authentication", async () => {
const res = await request(app).get("/v1/usage");
expect(res.status).toBe(401);
});
it("should include period, checkpoints, repositories, contexts, api_calls, and limits with expected fields", async () => {
const res = await request(app)
.get("/v1/usage")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
// Period fields
expect(res.body.period).toHaveProperty("start");
expect(res.body.period).toHaveProperty("end");
// Checkpoints fields
expect(res.body.checkpoints).toHaveProperty("count");
expect(res.body.checkpoints).toHaveProperty("storage_bytes");
expect(res.body.checkpoints).toHaveProperty("storage_formatted");
// Repositories fields
expect(res.body.repositories).toHaveProperty("count");
expect(res.body.repositories).toHaveProperty("indexed_files");
// Contexts fields
expect(res.body.contexts).toHaveProperty("count");
// API calls fields
expect(res.body.api_calls).toHaveProperty("count");
// Limits fields
expect(res.body.limits).toHaveProperty("checkpoints");
expect(res.body.limits).toHaveProperty("storage_bytes");
expect(res.body.limits).toHaveProperty("storage_formatted");
expect(res.body.limits).toHaveProperty("repositories");
expect(res.body.limits).toHaveProperty("indexed_files");
expect(res.body.limits).toHaveProperty("contexts");
expect(res.body.limits).toHaveProperty("api_calls_per_day");
});
});
// ==========================================================================
// GET /v1/usage/history - Historical usage data
// ==========================================================================
describe("GET /v1/usage/history", () => {
it("should return history with data array", async () => {
const res = await request(app)
.get("/v1/usage/history")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("start_date");
expect(res.body).toHaveProperty("end_date");
expect(res.body).toHaveProperty("granularity");
expect(res.body).toHaveProperty("data");
expect(Array.isArray(res.body.data)).toBe(true);
});
it("should return 400 for invalid granularity", async () => {
const res = await request(app)
.get("/v1/usage/history")
.query({ granularity: "hourly" })
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(400);
expect(res.body).toHaveProperty("error");
expect(res.body.error).toHaveProperty("type", "invalid_request_error");
});
it("should accept valid granularity param (weekly)", async () => {
const res = await request(app)
.get("/v1/usage/history")
.query({ granularity: "weekly" })
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body.granularity).toBe("weekly");
expect(Array.isArray(res.body.data)).toBe(true);
});
});
// ==========================================================================
// GET /v1/usage/breakdown - Breakdown by resource type
// ==========================================================================
describe("GET /v1/usage/breakdown", () => {
it("should return repositories, checkpoints, contexts, and storage", async () => {
const res = await request(app)
.get("/v1/usage/breakdown")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("repositories");
expect(res.body).toHaveProperty("checkpoints");
expect(res.body).toHaveProperty("contexts");
expect(res.body).toHaveProperty("storage");
expect(Array.isArray(res.body.repositories)).toBe(true);
expect(Array.isArray(res.body.checkpoints)).toBe(true);
expect(Array.isArray(res.body.contexts)).toBe(true);
expect(res.body.storage).toHaveProperty("breakdown");
expect(Array.isArray(res.body.storage.breakdown)).toBe(true);
});
});
// ==========================================================================
// GET /v1/usage/limits - Plan limits
// ==========================================================================
describe("GET /v1/usage/limits", () => {
it("should return plan, limits, current, and percentage", async () => {
const res = await request(app)
.get("/v1/usage/limits")
.set("X-API-Key", TEST_API_KEY);
expect(res.status).toBe(200);
expect(res.body).toHaveProperty("plan");
expect(res.body).toHaveProperty("limits");
expect(res.body).toHaveProperty("current");
expect(res.body).toHaveProperty("percentage");
// The seeded user has a "free" plan
expect(res.body.plan).toBe("free");
// Limits should contain all expected keys
expect(res.body.limits).toHaveProperty("checkpoints");
expect(res.body.limits).toHaveProperty("storage_bytes");
expect(res.body.limits).toHaveProperty("storage_formatted");
expect(res.body.limits).toHaveProperty("repositories");
expect(res.body.limits).toHaveProperty("indexed_files");
expect(res.body.limits).toHaveProperty("contexts");
expect(res.body.limits).toHaveProperty("api_calls_per_day");
// Current should contain all expected keys
expect(res.body.current).toHaveProperty("checkpoints");
expect(res.body.current).toHaveProperty("storage_bytes");
expect(res.body.current).toHaveProperty("storage_formatted");
expect(res.body.current).toHaveProperty("repositories");
expect(res.body.current).toHaveProperty("indexed_files");
expect(res.body.current).toHaveProperty("contexts");
expect(res.body.current).toHaveProperty("api_calls_today");
// Percentage should contain all expected keys
expect(res.body.percentage).toHaveProperty("checkpoints");
expect(res.body.percentage).toHaveProperty("storage");
expect(res.body.percentage).toHaveProperty("repositories");
expect(res.body.percentage).toHaveProperty("indexed_files");
expect(res.body.percentage).toHaveProperty("contexts");
expect(res.body.percentage).toHaveProperty("api_calls");
});
});
});