test: add integration tests for pdf-to-image endpoints

This commit is contained in:
Siddharth Kumar Sah
2026-04-10 20:56:13 +08:00
parent 44bbfba80d
commit 48cf919fb7
+276
View File
@@ -0,0 +1,276 @@
import { readFileSync } from "node:fs";
import { join } from "node:path";
import { afterAll, beforeAll, describe, expect, it } from "vitest";
import { buildTestApp, createMultipartPayload, loginAsAdmin, type TestApp } from "./test-server.js";
const FIXTURES = join(__dirname, "..", "fixtures");
const PDF_3PAGE = readFileSync(join(FIXTURES, "test-3page.pdf"));
let testApp: TestApp;
let app: TestApp["app"];
let adminToken: string;
beforeAll(async () => {
testApp = await buildTestApp();
app = testApp.app;
adminToken = await loginAsAdmin(app);
}, 30_000);
afterAll(async () => {
await testApp.cleanup();
}, 10_000);
describe("POST /api/v1/tools/pdf-to-image/info", () => {
it("returns page count for a valid PDF", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "test.pdf",
contentType: "application/pdf",
content: PDF_3PAGE,
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image/info",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
expect(res.statusCode).toBe(200);
const data = JSON.parse(res.body);
expect(data.pageCount).toBe(3);
});
it("returns 400 for invalid PDF", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "bad.pdf",
contentType: "application/pdf",
content: Buffer.from("not a pdf"),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image/info",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
expect(res.statusCode).toBe(400);
});
it("returns 400 when no file is provided", async () => {
const { body, contentType } = createMultipartPayload([{ name: "other", content: "hello" }]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image/info",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
expect(res.statusCode).toBe(400);
});
});
describe("POST /api/v1/tools/pdf-to-image", () => {
it("converts a single page to PNG and returns a download URL", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "test.pdf",
contentType: "application/pdf",
content: PDF_3PAGE,
},
{
name: "settings",
content: JSON.stringify({ format: "png", dpi: 72, pages: "1" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
expect(res.statusCode).toBe(200);
const data = JSON.parse(res.body);
expect(data.downloadUrl).toContain("/api/v1/download/");
expect(data.downloadUrl).toContain("page-1.png");
expect(data.pageCount).toBe(3);
expect(data.selectedPages).toEqual([1]);
expect(data.format).toBe("png");
});
it("converts a single page to JPG", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "test.pdf",
contentType: "application/pdf",
content: PDF_3PAGE,
},
{
name: "settings",
content: JSON.stringify({ format: "jpg", dpi: 72, pages: "2" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
expect(res.statusCode).toBe(200);
const data = JSON.parse(res.body);
expect(data.downloadUrl).toContain("page-2.jpg");
});
it("returns a ZIP for multiple pages", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "test.pdf",
contentType: "application/pdf",
content: PDF_3PAGE,
},
{
name: "settings",
content: JSON.stringify({ format: "png", dpi: 72, pages: "1-3" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
// reply.hijack() bypasses Fastify's normal response handling, so
// app.inject() returns statusCode 200 and the raw ZIP payload.
expect(res.statusCode).toBe(200);
expect(res.rawPayload.length).toBeGreaterThan(0);
// ZIP files start with the PK magic bytes (0x50, 0x4B)
expect(res.rawPayload[0]).toBe(0x50);
expect(res.rawPayload[1]).toBe(0x4b);
});
it("uses defaults when no settings provided", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "test.pdf",
contentType: "application/pdf",
content: PDF_3PAGE,
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
// Default pages="all" means 3 pages, which triggers ZIP streaming
expect(res.statusCode).toBe(200);
expect(res.rawPayload.length).toBeGreaterThan(0);
// Verify ZIP magic bytes
expect(res.rawPayload[0]).toBe(0x50);
expect(res.rawPayload[1]).toBe(0x4b);
});
it("returns 400 for invalid page range", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "test.pdf",
contentType: "application/pdf",
content: PDF_3PAGE,
},
{
name: "settings",
content: JSON.stringify({ pages: "5-10" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
expect(res.statusCode).toBe(400);
const data = JSON.parse(res.body);
expect(data.error).toMatch(/out of range/);
});
it("returns 400 for invalid PDF", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "bad.pdf",
contentType: "application/pdf",
content: Buffer.from("not a pdf"),
},
{
name: "settings",
content: JSON.stringify({ pages: "1" }),
},
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
// mupdf may attempt to repair the broken file, so the error can surface
// during rendering rather than at open time, resulting in a 422.
expect([400, 422]).toContain(res.statusCode);
});
it("returns 400 for invalid settings JSON", async () => {
const { body, contentType } = createMultipartPayload([
{
name: "file",
filename: "test.pdf",
contentType: "application/pdf",
content: PDF_3PAGE,
},
{ name: "settings", content: "not json" },
]);
const res = await app.inject({
method: "POST",
url: "/api/v1/tools/pdf-to-image",
body,
headers: {
"content-type": contentType,
authorization: `Bearer ${adminToken}`,
},
});
expect(res.statusCode).toBe(400);
const data = JSON.parse(res.body);
expect(data.error).toMatch(/JSON/);
});
});