alexion
38026f963d
Tracer bullet for gitea-axi: runnable npm package on axi-sdk-js with gitea-js as the sole HTTP layer, ESM on Node 20+. - issue list with --state/--limit, default fields, count line from X-Total-Count, type=issues guard, explicit empty state, and next-step suggestions - repo context detection from the git origin remote (SSH/scp/HTTPS), tea credential discovery with the three-way login-matching split, and -R/--repo and --login overrides (flag > env > auto) - token retrieval via tea login helper get: tea's login list JSON carries no token (ADR 0001 amended) - full AxiError classification table with path-based 404 split, TOON errors on stdout, exit codes 0/1/2 - test mode (GITEA_AXI_API_URL/TOKEN/REPO) suppressing subprocesses, fixture server, and vitest suites driving the CLI seam (50 tests)
97 lines
2.9 KiB
TypeScript
97 lines
2.9 KiB
TypeScript
import { readFileSync } from "node:fs";
|
|
import { createServer, type Server } from "node:http";
|
|
|
|
export interface FixtureRoute {
|
|
method: string;
|
|
/** Exact pathname to match, e.g. "/api/v1/repos/o/r/issues". */
|
|
path: string;
|
|
/** Query params that must all be present with these exact values. */
|
|
query?: Record<string, string>;
|
|
status?: number;
|
|
headers?: Record<string, string>;
|
|
/** Inline JSON body; mutually exclusive with `fixture`. */
|
|
body?: unknown;
|
|
/** Name of a JSON file in test/fixtures to serve as the body. */
|
|
fixture?: string;
|
|
}
|
|
|
|
export interface RecordedRequest {
|
|
method: string;
|
|
path: string;
|
|
query: Record<string, string>;
|
|
headers: Record<string, string>;
|
|
}
|
|
|
|
export interface FixtureServer {
|
|
url: string;
|
|
requests: RecordedRequest[];
|
|
close: () => Promise<void>;
|
|
}
|
|
|
|
function loadBody(route: FixtureRoute): unknown {
|
|
if (route.fixture !== undefined) {
|
|
return JSON.parse(
|
|
readFileSync(new URL(`./fixtures/${route.fixture}`, import.meta.url), "utf8"),
|
|
);
|
|
}
|
|
return route.body ?? {};
|
|
}
|
|
|
|
function matches(route: FixtureRoute, request: RecordedRequest): boolean {
|
|
if (route.method !== request.method || route.path !== request.path) {
|
|
return false;
|
|
}
|
|
for (const [key, value] of Object.entries(route.query ?? {})) {
|
|
if (request.query[key] !== value) {
|
|
return false;
|
|
}
|
|
}
|
|
return true;
|
|
}
|
|
|
|
export async function startFixtureServer(routes: FixtureRoute[]): Promise<FixtureServer> {
|
|
const requests: RecordedRequest[] = [];
|
|
const server: Server = createServer((req, res) => {
|
|
const url = new URL(req.url ?? "/", "http://fixture");
|
|
const recorded: RecordedRequest = {
|
|
method: req.method ?? "GET",
|
|
path: url.pathname,
|
|
query: Object.fromEntries(url.searchParams),
|
|
headers: Object.fromEntries(
|
|
Object.entries(req.headers).map(([k, v]) => [k, Array.isArray(v) ? v.join(",") : (v ?? "")]),
|
|
),
|
|
};
|
|
requests.push(recorded);
|
|
const route = routes.find((candidate) => matches(candidate, recorded));
|
|
if (!route) {
|
|
res.writeHead(599, { "content-type": "application/json" });
|
|
res.end(
|
|
JSON.stringify({
|
|
message: `no fixture route matched ${recorded.method} ${recorded.path} ${JSON.stringify(recorded.query)}`,
|
|
}),
|
|
);
|
|
return;
|
|
}
|
|
res.writeHead(route.status ?? 200, {
|
|
"content-type": "application/json",
|
|
...route.headers,
|
|
});
|
|
res.end(JSON.stringify(loadBody(route)));
|
|
});
|
|
await new Promise<void>((resolve) => {
|
|
server.listen(0, "127.0.0.1", resolve);
|
|
});
|
|
const address = server.address();
|
|
if (address === null || typeof address === "string") {
|
|
throw new Error("fixture server has no address");
|
|
}
|
|
return {
|
|
url: `http://127.0.0.1:${address.port}`,
|
|
requests,
|
|
close: () =>
|
|
new Promise<void>((resolve, reject) => {
|
|
server.close((error) => (error ? reject(error) : resolve()));
|
|
}),
|
|
};
|
|
}
|