Rebuild: NZBs from the chunk store, and a catalog search

lib/nzb (buildNzb, parseNzb) from the current app; NzbService builds a
release's NZB from its chunks; GET /api/v1/releases?q= (every word of the
name) and GET /api/v1/releases/:id/nzb behind the api guard. A test stores
a batch, finds the release and reads its NZB back.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tests/functional/releases_api.spec.ts

@@ -0,0 +1,48 @@
+import { test } from '@japa/runner'
+import db from '@adonisjs/lucid/services/db'
+import testUtils from '@adonisjs/core/services/test_utils'
+import User from '#models/user'
+import BatchStore from '#services/batch_store'
+import { RangeIndexer } from '#lib/edge/index'
+import { parseNzb } from '#lib/nzb/index'
+import { DEFAULT_RULES } from '#lib/rules/index'
+import type { Overview } from '#lib/nntp/index'
+
+const GROUP = 'alt.binaries.test'
+
+function file(name: string, counter: string, parts: number, at: number): Overview[] {
+  return Array.from({ length: parts }, (_, i) => [at + i, {
+    'subject': `${counter} - "${name}" yEnc (${i + 1}/${parts})`, 'from': 'p <p@x>', 'date': 'Mon, 05 Oct 2026 10:00:00 +0000',
+    'message-id': `<${name}-${i + 1}@test>`, ':bytes': String(700000 + i), 'xref': `news.example ${GROUP}:${at + i}`,
+  }] as Overview)
+}
+
+test.group('Releases API', (group) => {
+  group.each.setup(() => testUtils.db().withGlobalTransaction())
+
+  test('finds a release by the words of its name and builds its NZB from the chunk store', async ({ client, assert }) => {
+    const [g] = await db.table('groups').insert({ name: GROUP, priority: 1 }).returning('id')
+    const [n] = await db.table('nodes').insert({ name: 'api-node' }).returning('id')
+    const [r] = await db.table('ranges').insert({ group_id: g.id, start_id: 1, end_id: 1000, next_id: 1, status: 'leased', node_id: n.id }).returning('id')
+    const indexer = new RangeIndexer({ group: GROUP, start: 1, end: 1000, rules: { ...DEFAULT_RULES, samplePercent: 0, droppedSignatures: [], priorities: { [GROUP]: 1 } } })
+    indexer.add([...file('Some.Show.S01E01.1080p.WEB.part1.rar', 'Some.Show.S01E01 [1/2]', 3, 100), ...file('Some.Show.S01E01.1080p.WEB.par2', 'Some.Show.S01E01 [2/2]', 1, 200)], 1001)
+    indexer.finish()
+    await BatchStore.store(Number(r.id), Number(n.id), indexer.take())
+
+    const user = await User.create({ email: 'u@example.invalid', password: 'secret-password' })
+    const token = (await User.accessTokens.create(user)).value!.release()
+    ;(await client.get('/api/v1/releases?q=show s01e01')).assertStatus(401)
+    const found = await client.get('/api/v1/releases?q=show s01e01').bearerToken(token)
+    found.assertStatus(200)
+    const releases = (found.body() as { releases: { id: number; name: string }[] }).releases
+    assert.lengthOf(releases, 1)
+
+    const nzb = await client.get(`/api/v1/releases/${releases[0].id}/nzb`).bearerToken(token)
+    nzb.assertStatus(200)
+    assert.include(nzb.header('content-type'), 'application/x-nzb')
+    const parsed = parseNzb(nzb.text())!
+    assert.equal(parsed.meta.name, releases[0].name)
+    assert.deepEqual(parsed.files.map((f) => f.segments.length), [1, 3])
+    assert.equal(parsed.files[1].segments[2].id, 'Some.Show.S01E01.1080p.WEB.part1.rar-3@test')
+  })
+})

tests/unit/nzb/nzb.spec.ts

@@ -0,0 +1,56 @@
+import { test } from '@japa/runner'
+import { buildNzb } from '#lib/nzb/index'
+
+test.group('nzb / buildNzb', () => {
+  test('writes files, groups and ordered segments', ({ assert }) => {
+    const xml = buildNzb(
+      [
+        {
+          name: 'Some.Show.S01E01.mkv',
+          poster: 'poster@example.invalid',
+          date: 1_790_000_000_000,
+          groups: ['alt.binaries.test'],
+          segments: [{ number: 2, id: 'b@x', size: 700 }, { number: 1, id: 'a@x', size: 800 }],
+        },
+      ],
+      { title: 'Some.Show.S01E01' }
+    )
+    assert.include(xml, '<!DOCTYPE nzb PUBLIC "-//newzBin//DTD NZB 1.1//EN"')
+    assert.include(xml, '<meta type="name">Some.Show.S01E01</meta>')
+    assert.include(xml, 'subject="&quot;Some.Show.S01E01.mkv&quot; yEnc (1/2)"')
+    assert.include(xml, 'date="1790000000"')
+    assert.include(xml, '<group>alt.binaries.test</group>')
+    assert.isBelow(xml.indexOf('>a@x<'), xml.indexOf('>b@x<'))
+    assert.include(xml, '<segment bytes="800" number="1">a@x</segment>')
+  })
+})
+
+test.group('nzb / parseNzb', () => {
+  test('reads meta, files, groups and segments, decoding entities', async ({ assert }) => {
+    const { parseNzb } = await import('#lib/nzb/index')
+    const xml = `<?xml version="1.0" encoding="utf-8" ?>
+<!DOCTYPE nzb PUBLIC "-//newzBin//DTD NZB 0.9//EN" "http://www.newzbin.com/DTD/nzb/nzb-0.9.dtd">
+<nzb xmlns="http://www.newzbin.com/DTD/2003/nzb">
+  <head><meta type="name">Some.Show.S01E01</meta><meta type="password">s3cr&amp;t</meta></head>
+  <file poster="Yenc@power-post.org (Cosmo71)" date="1790598923" subject="Wond40 &#x22;Nachbe&#x22; x.part1.rar&#x22; yEnc (0001/2)">
+    <groups><group>alt.binaries.bloaf</group></groups>
+    <segments>
+      <segment bytes="1000" number="2">b@x.local</segment>
+      <segment bytes="2000" number="1">&lt;a@x.local&gt;</segment>
+    </segments>
+  </file>
+  <file poster="p" date="1" subject="empty"><groups/><segments></segments></file>
+</nzb>`
+    const nzb = parseNzb(xml)!
+    assert.deepEqual(nzb.meta, { name: 'Some.Show.S01E01', password: 's3cr&t' })
+    assert.lengthOf(nzb.files, 1)
+    assert.equal(nzb.files[0].subject, 'Wond40 "Nachbe" x.part1.rar" yEnc (0001/2)')
+    assert.deepEqual(nzb.files[0].groups, ['alt.binaries.bloaf'])
+    assert.deepEqual(nzb.files[0].segments, [
+      { number: 1, bytes: 2000, id: 'a@x.local' },
+      { number: 2, bytes: 1000, id: 'b@x.local' },
+    ])
+    assert.isNull(parseNzb('<html>not an nzb</html>'))
+  })
+})
+