Files
Lucas WintherandClaude Opus 5.5 777ae2cc37 feat: resolve Phase 1 contract requests and compose every feature
Contracts and core:
- Feature gains auth and stop; FeatureFactory; core composeServer builds the
  context, runs the factories, then the job queue from the union of their jobs
  (R8/R14). startServer uses it; main.ts composes learner, import, studio, AI.
- AppConfig/loadConfig own the layout and settings: courseDirs include
  <dataDir>/courses and <dataDir>/worktrees, studioReposDir, cacheDir,
  importRoots, uploadMaxMb, aiAllowedBaseUrls, transcribeUrl, python.
  resolveConfig derives the same for tests; cachePaths shares the importer's
  cache layout.
- canView: the global author role views every course (R14); the learner,
  studio and AI packages all call it.
- migrate(db, packages): core first, then packages in name order.
- Media: nosniff on every response, a sandbox CSP on svg/html/js; a Range on
  an empty file is 416.
- courseUrl/lessonUrl and the lesson route patterns live in @stc/contracts.

Packages:
- import, studio and AI read AppConfig instead of process.env; the importer
  refuses ids used by studio/repos.
- learner migrations run through core migrate; library covers fall back to
  the importer's cached candidate behind a canView-checked route.
- studio preview renders through the learner LessonView (anchors honoured,
  draft URLs); AI drafts go to the studio draft branch for studio courses (as
  the requesting user) and to <dataDir>/drafts otherwise, and the generator
  page says which.

Web: tsconfig paths for @stc/<feature>/web browser entries; features.ts
imports them by package name; nav.roles hides links by role.

Tests: compose, config, canView, media headers, migrations order, covers,
preview, nav, SPA bundle without server code, and an end-to-end flow on
SQLite and Postgres.

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

49 lines
2.2 KiB
TypeScript

import { mkdtempSync } from "node:fs";
import { tmpdir } from "node:os";
import { join, resolve } from "node:path";
import type { AppConfig, JobQueue, ServerContext } from "@stc/contracts";
import { createApp, resolveConfig } from "@stc/core";
import { createCourseRepository } from "@stc/course-format";
import type { Db } from "@stc/db";
import { learnerFeature } from "../src/server/feature";
export const FIXTURES = resolve(import.meta.dir, "../../../fixtures/courses");
export const ORIGIN = "http://localhost:3000";
const fakeJobs: JobQueue = { enqueue: async () => "j", get: async () => null, list: async () => [] };
export async function makeApp(db: Db, courseDirs: string[] = [FIXTURES]) {
const config: AppConfig = resolveConfig({
port: 0, databaseUrl: "", dataDir: mkdtempSync(join(tmpdir(), "stc-learner-")), courseDirs,
secret: "test-secret-0123456789abcdef0123456789", publicUrl: ORIGIN,
});
const ctx: ServerContext = {
config, db, courses: await createCourseRepository(courseDirs), jobs: fakeJobs,
auth: { userFromRequest: async () => null },
};
const feature = learnerFeature(ctx);
ctx.auth = feature.auth;
const app = createApp(ctx, [feature]);
async function call(method: string, path: string, opts: { body?: unknown; cookie?: string; headers?: Record<string, string> } = {}) {
const headers: Record<string, string> = { origin: ORIGIN, ...opts.headers };
if (opts.cookie) headers.cookie = opts.cookie;
let body: BodyInit | undefined;
if (opts.body !== undefined) { headers["content-type"] = "application/json"; body = JSON.stringify(opts.body); }
return app.fetch(new Request(ORIGIN + path, { method, headers, body }));
}
/** Signs up and returns a cookie header for the new session. */
async function signUp(email: string, name = email.split("@")[0]!, password = "correct horse battery") {
const r = await call("POST", "/api/auth/sign-up/email", { body: { email, name, password } });
if (r.status !== 200) throw new Error(`sign-up failed ${r.status}: ${await r.text()}`);
return cookieFrom(r);
}
return { app, ctx, feature, call, signUp };
}
export function cookieFrom(r: Response): string {
return r.headers.getSetCookie().map((c) => c.split(";")[0]).filter((c) => !c.endsWith("=")).join("; ");
}