82 lines
3.9 KiB
TypeScript
82 lines
3.9 KiB
TypeScript
|
/**
|
||
|
|
* THE SESSION MARKDOWN EXPORT ROUTE (owner, release polish 2026-10-06):
|
||
|
|
* GET /api/chats/:id/markdown — the user-facing export. The engine
|
||
|
|
* itself is pinned by tests/session-markdown.test.ts; this file pins
|
||
|
|
* the ROUTE contract: 404 unknown chat, the attachment headers, the
|
||
|
|
* slugified filename, the anchorless document with the title header.
|
||
|
|
*
|
||
|
|
* Runs under an isolated LH_DATA_DIR (the chat-birth-stamp discipline:
|
||
|
|
* the seam is set before any config-loading import, so every
|
||
|
|
* app-module import is dynamic).
|
||
|
|
*/
|
||
|
|
import assert from "node:assert/strict";
|
||
|
|
import fs from "node:fs";
|
||
|
|
import * as os from "node:os";
|
||
|
|
import * as path from "node:path";
|
||
|
|
import { after, before, describe, it } from "node:test";
|
||
|
|
|
||
|
|
// ── the seam, BEFORE any config-loading import ──────────────────────────────
|
||
|
|
const TMP_DATA = fs.mkdtempSync(path.join(os.tmpdir(), "lh-md-export-"));
|
||
|
|
process.env.LH_DATA_DIR = TMP_DATA;
|
||
|
|
|
||
|
|
/** The route handler + the store seam, loaded AFTER the env is set. */
|
||
|
|
type Get = (req: Request, ctx: { params: Promise<{ id: string }> }) => Promise<Response>;
|
||
|
|
let GET: Get;
|
||
|
|
let createChat: (title: string, kind?: "practice") => { id: string; title: string };
|
||
|
|
let saveMessages: (id: string, messages: unknown[]) => void;
|
||
|
|
|
||
|
|
before(async () => {
|
||
|
|
const route = await import("../app/api/chats/[id]/markdown/route.ts");
|
||
|
|
GET = route.GET;
|
||
|
|
const server = await import("../src/server/chats.ts");
|
||
|
|
createChat = server.createChat;
|
||
|
|
const { chatStore } = await import("../src/store/chats.ts");
|
||
|
|
saveMessages = (id, messages) => chatStore.saveMessages(id, messages as never);
|
||
|
|
});
|
||
|
|
|
||
|
|
describe("GET /api/chats/:id/markdown", () => {
|
||
|
|
it("404s an unknown chat", async () => {
|
||
|
|
const res = await GET(new Request("http://x/api/chats/nope/markdown"), { params: Promise.resolve({ id: "nope" }) });
|
||
|
|
assert.equal(res.status, 404);
|
||
|
|
});
|
||
|
|
|
||
|
|
it("exports the session as an anchorless markdown attachment, filename from the title", async () => {
|
||
|
|
const chat = createChat("Relational Databases — Joins & Normal Forms");
|
||
|
|
saveMessages(chat.id, [
|
||
|
|
{ id: "m1", role: "user", content: "Teach me joins" },
|
||
|
|
{ id: "m2", role: "assistant", content: "A join combines rows." },
|
||
|
|
]);
|
||
|
|
const res = await GET(new Request("http://x/api"), { params: Promise.resolve({ id: chat.id }) });
|
||
|
|
assert.equal(res.status, 200);
|
||
|
|
assert.equal(res.headers.get("content-type"), "text/markdown; charset=utf-8");
|
||
|
|
const disposition = res.headers.get("content-disposition") ?? "";
|
||
|
|
assert.ok(disposition.startsWith("attachment;"), "it is a download");
|
||
|
|
assert.ok(disposition.includes('filename="relational-databases-joins-normal-forms.md"'), "slugified title names the file");
|
||
|
|
const body = await res.text();
|
||
|
|
assert.ok(body.startsWith("# Relational Databases"), "the title mints the document header");
|
||
|
|
assert.ok(body.includes("### Learner"), "learner blocks render");
|
||
|
|
assert.ok(body.includes("### Teacher"), "teacher blocks render");
|
||
|
|
assert.ok(!body.includes("m1"), "anchorless — no message-id provenance in the user-facing export");
|
||
|
|
});
|
||
|
|
|
||
|
|
it("an unsalvageable title falls back to 'session'", async () => {
|
||
|
|
const chat = createChat("日本語"); // no ascii alphanumerics survive the slug
|
||
|
|
saveMessages(chat.id, [{ id: "m1", role: "user", content: "hello" }]);
|
||
|
|
const res = await GET(new Request("http://x/api"), { params: Promise.resolve({ id: chat.id }) });
|
||
|
|
assert.equal(res.status, 200);
|
||
|
|
assert.ok((res.headers.get("content-disposition") ?? "").includes('filename="session.md"'));
|
||
|
|
});
|
||
|
|
|
||
|
|
it("an empty session exports the bare header document", async () => {
|
||
|
|
const chat = createChat("Quiet one");
|
||
|
|
const res = await GET(new Request("http://x/api"), { params: Promise.resolve({ id: chat.id }) });
|
||
|
|
assert.equal(res.status, 200);
|
||
|
|
const body = await res.text();
|
||
|
|
assert.equal(body, "# Quiet one");
|
||
|
|
});
|
||
|
|
});
|
||
|
|
|
||
|
|
after(() => {
|
||
|
|
fs.rmSync(TMP_DATA, { recursive: true, force: true });
|
||
|
|
});
|