feat: add conversion_jobs repository

Also configures the MariaDB pool with timezone: 'auto', since the
default 'local' mode sends dates without timezone conversion and
silently broke expires_at comparisons whenever the app host and DB
server clocks differ (caught by the findExpiredJobs test).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

test/jobs/jobRepository.test.js

@@ -0,0 +1,122 @@
+import { describe, it, expect, beforeAll, afterAll, beforeEach } from 'vitest';
+import { getPool, closePool } from '../../src/db.js';
+import { loadConfig } from '../../src/config.js';
+import {
+  createJob,
+  getJobById,
+  getJobErrorLog,
+  markProcessing,
+  markDone,
+  markFailed,
+  findPendingJobs,
+  findExpiredJobs,
+  deleteJob,
+} from '../../src/jobs/jobRepository.js';
+
+let pool;
+
+beforeAll(() => {
+  pool = getPool(loadConfig());
+});
+
+afterAll(async () => {
+  await closePool();
+});
+
+beforeEach(async () => {
+  await pool.query('DELETE FROM conversion_jobs');
+});
+
+function baseJob(overrides = {}) {
+  return {
+    id: overrides.id ?? '11111111-1111-4111-8111-111111111111',
+    family: 'image',
+    sourceFormat: 'png',
+    targetFormat: 'webp',
+    originalFilename: 'photo.png',
+    inputPath: `${overrides.id ?? '11111111-1111-4111-8111-111111111111'}.png`,
+    inputMimeType: 'image/png',
+    expiresAt: new Date(Date.now() + 3600 * 1000),
+    ...overrides,
+  };
+}
+
+describe('jobRepository', () => {
+  it('creates and retrieves a pending job', async () => {
+    await createJob(pool, baseJob());
+
+    const job = await getJobById(pool, '11111111-1111-4111-8111-111111111111');
+
+    expect(job.status).toBe('pending');
+    expect(job.family).toBe('image');
+    expect(job.sourceFormat).toBe('png');
+    expect(job.targetFormat).toBe('webp');
+    expect(job.originalFilename).toBe('photo.png');
+    expect(job.inputMimeType).toBe('image/png');
+    expect(job.outputPath).toBeNull();
+    expect(job.errorMessage).toBeNull();
+  });
+
+  it('returns null for an unknown id', async () => {
+    const job = await getJobById(pool, '22222222-2222-4222-8222-222222222222');
+    expect(job).toBeNull();
+  });
+
+  it('transitions a job through processing to done', async () => {
+    await createJob(pool, baseJob());
+
+    await markProcessing(pool, '11111111-1111-4111-8111-111111111111');
+    const processing = await getJobById(pool, '11111111-1111-4111-8111-111111111111');
+    expect(processing.status).toBe('processing');
+
+    await markDone(pool, '11111111-1111-4111-8111-111111111111', {
+      outputPath: '11111111-1111-4111-8111-111111111111.webp',
+      outputMimeType: 'image/webp',
+    });
+    const done = await getJobById(pool, '11111111-1111-4111-8111-111111111111');
+    expect(done.status).toBe('done');
+    expect(done.outputPath).toBe('11111111-1111-4111-8111-111111111111.webp');
+    expect(done.outputMimeType).toBe('image/webp');
+  });
+
+  it('marks a job failed with a short message and a separate detailed log', async () => {
+    await createJob(pool, baseJob());
+
+    await markFailed(pool, '11111111-1111-4111-8111-111111111111', {
+      errorMessage: 'Conversion failed, please try again',
+      errorLog: 'Error: sharp threw at line 42\n  at convert (image.js:10:5)',
+    });
+
+    const job = await getJobById(pool, '11111111-1111-4111-8111-111111111111');
+    expect(job.status).toBe('failed');
+    expect(job.errorMessage).toBe('Conversion failed, please try again');
+    expect(job.errorLog).toBeUndefined();
+
+    const errorLog = await getJobErrorLog(pool, '11111111-1111-4111-8111-111111111111');
+    expect(errorLog).toBe('Error: sharp threw at line 42\n  at convert (image.js:10:5)');
+  });
+
+  it('finds pending jobs oldest first, up to a limit', async () => {
+    await createJob(pool, baseJob({ id: '33333333-3333-4333-8333-333333333333' }));
+    await createJob(pool, baseJob({ id: '44444444-4444-4444-8444-444444444444' }));
+    await createJob(pool, baseJob({ id: '55555555-5555-4555-8555-555555555555' }));
+
+    const jobs = await findPendingJobs(pool, 2);
+
+    expect(jobs).toHaveLength(2);
+    expect(jobs[0].id).toBe('33333333-3333-4333-8333-333333333333');
+    expect(jobs[1].id).toBe('44444444-4444-4444-8444-444444444444');
+  });
+
+  it('finds expired jobs and allows deleting them', async () => {
+    await createJob(pool, baseJob({ expiresAt: new Date(Date.now() - 1000) }));
+
+    const expired = await findExpiredJobs(pool);
+    expect(expired).toHaveLength(1);
+    expect(expired[0].id).toBe('11111111-1111-4111-8111-111111111111');
+
+    await deleteJob(pool, '11111111-1111-4111-8111-111111111111');
+    const afterDelete = await getJobById(pool, '11111111-1111-4111-8111-111111111111');
+    expect(afterDelete).toBeNull();
+  });
+});