Files
STCourses/packages/feature-studio/test/app-helpers.ts
T
Lucas WintherandClaude Opus 5.5 f02e30450c fix(studio): review round 2 - a conversion that fails after its commit recovers without a restart
- The convert job reloads the course on success and on failure, so learners
  get the intact import (rolled back) or the published studio course, never a
  course whose folder moved away.
- POST /convert on a course with an incomplete conversion (.converting-<id>,
  staging or retired folders) queues a job that recovers and finishes it
  instead of answering 409; the studio page shows "Conversion incomplete" with
  Retry for the owner.
- The 409 for pending import jobs names their kinds and ids; the dead withLock
  in git.ts is gone; the dot-folder discovery rule is documented in
  docs/operations.md and spec section 5.
- Route tests (SQLite and Postgres) inject a failed cross-filesystem copy, a
  checksum mismatch and a pre-commit failure.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-30 21:00:45 +01:00

69 lines
3.6 KiB
TypeScript

import { resolve } from "node:path";
import type { AppConfig, AuthUser, JobQueue, ServerContext } from "@stc/contracts";
import { createApp, createJobQueue, resolveConfig } from "@stc/core";
import { createCourseRepository } from "@stc/course-format";
import { connect, migrate } from "@stc/db";
import { studioFeature, type StudioFeatureOptions } from "../src/server/feature";
import { studioCourseDirs } from "../src/server/paths";
import { tempDir } from "./helpers";
export const REPO = resolve(import.meta.dir, "../../..");
export const users: Record<string, AuthUser> = {
ada: { id: "u-ada", email: "[email protected]", name: "Ada Lovelace", roles: ["author"], groups: [] },
owner: { id: "u-own", email: "[email protected]", name: "Olive Owner", roles: ["owner"], groups: [] },
lea: { id: "u-lea", email: "[email protected]", name: "Lea Learner", roles: ["learner"], groups: [] },
};
/** A server context like main.ts builds, with header-selected users (`x-user: ada`). */
export async function setupApp(extraCourseDirs: string[] = [], dbUrl = "sqlite://:memory:", prepare?: (dataDir: string) => void, configOverrides: Partial<AppConfig> = {}, featureOpts: StudioFeatureOptions = {}) {
const dataDir = tempDir();
prepare?.(dataDir);
let dropSchema = async () => {};
if (dbUrl.startsWith("postgres")) {
// a private schema per test, like packages/db's forEachDb
const schema = `t_${Bun.randomUUIDv7().replaceAll("-", "")}`;
const admin = await connect(dbUrl);
await admin.sql.unsafe(`CREATE SCHEMA ${schema}`);
const u = new URL(dbUrl);
u.searchParams.set("options", `-c search_path=${schema}`);
dbUrl = u.toString();
dropSchema = async () => { await admin.sql.unsafe(`DROP SCHEMA ${schema} CASCADE`); await admin.close(); };
}
const db = await connect(dbUrl);
await migrate(db);
const config = resolveConfig({ port: 0, databaseUrl: "sqlite://:memory:", dataDir, courseDirs: extraCourseDirs, secret: "t", publicUrl: "http://x", ...configOverrides });
const courses = await createCourseRepository(studioCourseDirs(config));
const ctx = {
config, db, courses, jobs: null as unknown as JobQueue,
auth: { userFromRequest: async (req: Request) => users[req.headers.get("x-user") ?? ""] ?? null },
} satisfies ServerContext;
const feature = studioFeature(ctx, { watch: false, ...featureOpts });
// the real queue, as composeServer builds it from the features' jobs
const queue = createJobQueue(db, feature.jobs ?? {}, { pollMs: 20 });
ctx.jobs = queue;
queue.start();
const app = createApp(ctx, [feature]);
const call = async (as: string | null, method: string, path: string, body?: unknown) => {
const headers: Record<string, string> = { origin: "http://x" };
if (as) headers["x-user"] = as;
let payload: BodyInit | undefined;
if (body instanceof FormData) payload = body;
else if (body !== undefined) { headers["content-type"] = "application/json"; payload = JSON.stringify(body); }
const r = await app.fetch(new Request(`http://x${path}`, { method, headers, body: payload }));
const text = await r.text();
let json: any = null;
try { json = JSON.parse(text); } catch { json = text; }
return { status: r.status, json };
};
/** Polls a job until it is done or failed. */
const waitJob = async (id: string) => {
for (let i = 0; i < 500; i++) {
const j = await queue.get(id);
if (j && (j.status === "done" || j.status === "failed")) return j;
await Bun.sleep(20);
}
throw new Error(`job ${id} did not finish`);
};
return { ctx, db, dataDir, feature, app, call, waitJob, stop: async () => { feature.stop(); await queue.stop(); await db.close(); await dropSchema(); } };
}