add tagging system for media items

Introduces user-defined tag categories and tags with a many-to-many
relationship to media items. Tags are stored in a SQLite database
(medialore.db via better-sqlite3) with ON DELETE CASCADE for automatic
cleanup. Users can manage categories and tags at /manage/tags, assign
tags to games in the detail modal, and tag mixed media files via a
hover button on each tile.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-25 17:29:24 -04:00
parent bf54b45fa1
commit f788b1a441
17 changed files with 1680 additions and 5 deletions

View File

@@ -1,5 +1,6 @@
import { NextRequest, NextResponse } from 'next/server'
import { getLibrary, removeLibrary } from '@/lib/libraries'
import { removeAllAssignmentsForLibrary } from '@/lib/tags'
export async function DELETE(
_request: NextRequest,
@@ -13,5 +14,6 @@ export async function DELETE(
}
removeLibrary(id)
removeAllAssignmentsForLibrary(id)
return new NextResponse(null, { status: 204 })
}

View File

@@ -0,0 +1,43 @@
import { NextRequest, NextResponse } from 'next/server'
import { getResolvedTagsForItem, addTagToItem, removeTagFromItem } from '@/lib/tags'
export async function GET(request: NextRequest) {
try {
const { searchParams } = new URL(request.url)
const mediaKey = searchParams.get('mediaKey')
if (!mediaKey) {
return NextResponse.json({ error: 'mediaKey is required' }, { status: 400 })
}
return NextResponse.json(getResolvedTagsForItem(mediaKey))
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 500 })
}
}
export async function POST(request: NextRequest) {
try {
const { mediaKey, tagId } = await request.json()
if (!mediaKey || !tagId) {
return NextResponse.json({ error: 'mediaKey and tagId are required' }, { status: 400 })
}
addTagToItem(mediaKey, tagId)
return new NextResponse(null, { status: 204 })
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 400 })
}
}
export async function DELETE(request: NextRequest) {
try {
const { searchParams } = new URL(request.url)
const mediaKey = searchParams.get('mediaKey')
const tagId = searchParams.get('tagId')
if (!mediaKey || !tagId) {
return NextResponse.json({ error: 'mediaKey and tagId are required' }, { status: 400 })
}
removeTagFromItem(mediaKey, tagId)
return new NextResponse(null, { status: 204 })
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 400 })
}
}

View File

@@ -0,0 +1,44 @@
import { NextRequest, NextResponse } from 'next/server'
import { updateCategory, deleteCategory, deleteCategoryForce, getTags } from '@/lib/tags'
export async function PATCH(
request: NextRequest,
{ params }: { params: Promise<{ id: string }> }
) {
try {
const { id } = await params
const { name } = await request.json()
const category = updateCategory(id, name)
return NextResponse.json(category)
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 400 })
}
}
export async function DELETE(
request: NextRequest,
{ params }: { params: Promise<{ id: string }> }
) {
try {
const { id } = await params
const { searchParams } = new URL(request.url)
const cascade = searchParams.get('cascade') === 'true'
if (cascade) {
deleteCategoryForce(id)
} else {
const tags = getTags(id)
if (tags.length > 0) {
return NextResponse.json(
{ error: `Category has ${tags.length} tag${tags.length === 1 ? '' : 's'}.`, tagCount: tags.length },
{ status: 409 }
)
}
deleteCategory(id)
}
return new NextResponse(null, { status: 204 })
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 400 })
}
}

View File

@@ -0,0 +1,20 @@
import { NextRequest, NextResponse } from 'next/server'
import { getCategories, addCategory } from '@/lib/tags'
export async function GET() {
try {
return NextResponse.json(getCategories())
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 500 })
}
}
export async function POST(request: NextRequest) {
try {
const { name } = await request.json()
const category = addCategory(name)
return NextResponse.json(category, { status: 201 })
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 400 })
}
}

View File

@@ -0,0 +1,29 @@
import { NextRequest, NextResponse } from 'next/server'
import { updateTag, deleteTag } from '@/lib/tags'
export async function PATCH(
request: NextRequest,
{ params }: { params: Promise<{ id: string }> }
) {
try {
const { id } = await params
const { name } = await request.json()
const tag = updateTag(id, name)
return NextResponse.json(tag)
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 400 })
}
}
export async function DELETE(
_request: NextRequest,
{ params }: { params: Promise<{ id: string }> }
) {
try {
const { id } = await params
deleteTag(id)
return new NextResponse(null, { status: 204 })
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 400 })
}
}

View File

@@ -0,0 +1,22 @@
import { NextRequest, NextResponse } from 'next/server'
import { getTags, addTag } from '@/lib/tags'
export async function GET(request: NextRequest) {
try {
const { searchParams } = new URL(request.url)
const categoryId = searchParams.get('categoryId') ?? undefined
return NextResponse.json(getTags(categoryId))
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 500 })
}
}
export async function POST(request: NextRequest) {
try {
const { name, categoryId } = await request.json()
const tag = addTag(name, categoryId)
return NextResponse.json(tag, { status: 201 })
} catch (err) {
return NextResponse.json({ error: (err as Error).message }, { status: 400 })
}
}

10
src/app/manage/layout.tsx Normal file
View File

@@ -0,0 +1,10 @@
import ManageSubNav from '@/components/ManageSubNav'
export default function ManageLayout({ children }: { children: React.ReactNode }) {
return (
<div>
<ManageSubNav />
{children}
</div>
)
}

View File

@@ -0,0 +1,528 @@
'use client'
import { useEffect, useState, useRef } from 'react'
import type { Tag, TagCategory } from '@/types'
// ─── Main Page ────────────────────────────────────────────────────────────────
export default function ManageTagsPage() {
const [categories, setCategories] = useState<TagCategory[]>([])
const [tags, setTags] = useState<Tag[]>([])
const [loading, setLoading] = useState(true)
const refresh = () => {
Promise.all([
fetch('/api/tags/categories').then((r) => r.json()),
fetch('/api/tags/items').then((r) => r.json()),
])
.then(([cats, tgs]: [TagCategory[], Tag[]]) => {
setCategories(cats)
setTags(tgs)
setLoading(false)
})
.catch(() => setLoading(false))
}
useEffect(() => {
refresh()
}, [])
const tagsForCategory = (categoryId: string) => tags.filter((t) => t.categoryId === categoryId)
return (
<div className="max-w-2xl">
<h1 className="text-2xl font-semibold mb-1" style={{ color: 'var(--text-primary)' }}>
Manage Tags
</h1>
<p className="text-sm mb-8" style={{ color: 'var(--text-secondary)' }}>
Create tag categories and tags to organize your media items.
</p>
<Section title="Tag Categories & Tags">
{loading ? (
<LoadingRows />
) : categories.length === 0 ? (
<p className="text-sm py-4" style={{ color: 'var(--text-secondary)' }}>
No categories yet. Add one below.
</p>
) : (
<div className="divide-y" style={{ borderColor: 'var(--border)' }}>
{categories.map((cat) => (
<CategoryBlock
key={cat.id}
category={cat}
tags={tagsForCategory(cat.id)}
onChanged={refresh}
/>
))}
</div>
)}
</Section>
<Section title="Add a Category">
<AddCategoryForm onAdded={refresh} />
</Section>
</div>
)
}
// ─── Category Block ───────────────────────────────────────────────────────────
function CategoryBlock({
category,
tags,
onChanged,
}: {
category: TagCategory
tags: Tag[]
onChanged: () => void
}) {
const [editing, setEditing] = useState(false)
const [editName, setEditName] = useState(category.name)
const [saving, setSaving] = useState(false)
const [confirming, setConfirming] = useState(false)
const [deleting, setDeleting] = useState(false)
const [error, setError] = useState<string | null>(null)
const cancelRef = useRef<ReturnType<typeof setTimeout> | null>(null)
const handleRename = async (e: React.FormEvent) => {
e.preventDefault()
setError(null)
setSaving(true)
try {
const res = await fetch(`/api/tags/categories/${encodeURIComponent(category.id)}`, {
method: 'PATCH',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: editName }),
})
const data = await res.json()
if (!res.ok) { setError(data.error); setSaving(false); return }
setEditing(false)
onChanged()
} catch {
setError('Network error.')
}
setSaving(false)
}
const handleDeleteClick = () => {
if (!confirming) {
setConfirming(true)
cancelRef.current = setTimeout(() => setConfirming(false), 4000)
return
}
if (cancelRef.current) clearTimeout(cancelRef.current)
setDeleting(true)
const cascade = tags.length > 0
fetch(
`/api/tags/categories/${encodeURIComponent(category.id)}${cascade ? '?cascade=true' : ''}`,
{ method: 'DELETE' }
)
.then(() => onChanged())
.catch(() => setDeleting(false))
}
const handleCancel = () => {
if (cancelRef.current) clearTimeout(cancelRef.current)
setConfirming(false)
}
return (
<div className="py-4 first:pt-0 last:pb-0">
{/* Category header */}
<div className="flex items-center gap-2 mb-3">
{editing ? (
<form onSubmit={handleRename} className="flex items-center gap-2 flex-1 min-w-0">
<input
type="text"
value={editName}
onChange={(e) => setEditName(e.target.value)}
autoFocus
required
className="flex-1 rounded-lg px-3 py-1.5 text-sm outline-none"
style={{
backgroundColor: 'var(--background)',
border: '1px solid var(--accent)',
color: 'var(--text-primary)',
}}
/>
<button
type="submit"
disabled={saving}
className="text-xs px-2.5 py-1.5 rounded-lg transition-colors disabled:opacity-50"
style={{ backgroundColor: 'var(--accent)', color: '#fff' }}
>
{saving ? 'Saving…' : 'Save'}
</button>
<button
type="button"
onClick={() => { setEditing(false); setEditName(category.name); setError(null) }}
className="text-xs px-2.5 py-1.5 rounded-lg transition-colors"
style={{ backgroundColor: 'var(--border)', color: 'var(--text-secondary)' }}
>
Cancel
</button>
</form>
) : (
<>
<span className="font-medium text-sm flex-1" style={{ color: 'var(--text-primary)' }}>
{category.name}
<span className="ml-2 font-normal text-xs" style={{ color: 'var(--text-secondary)' }}>
{tags.length} tag{tags.length === 1 ? '' : 's'}
</span>
</span>
<button
onClick={() => { setEditing(true); setEditName(category.name) }}
className="text-xs px-2.5 py-1.5 rounded-lg transition-colors"
style={{ backgroundColor: 'var(--border)', color: 'var(--text-secondary)' }}
onMouseEnter={(e) => ((e.currentTarget as HTMLElement).style.color = 'var(--text-primary)')}
onMouseLeave={(e) => ((e.currentTarget as HTMLElement).style.color = 'var(--text-secondary)')}
>
Rename
</button>
{confirming && (
<button
onClick={handleCancel}
className="text-xs px-2.5 py-1.5 rounded-lg transition-colors"
style={{ color: 'var(--text-secondary)', backgroundColor: 'var(--border)' }}
>
Cancel
</button>
)}
<button
onClick={handleDeleteClick}
disabled={deleting}
className="text-xs px-2.5 py-1.5 rounded-lg transition-colors disabled:opacity-50"
style={{
backgroundColor: confirming ? '#7f1d1d' : 'var(--border)',
color: confirming ? '#fca5a5' : 'var(--text-secondary)',
}}
onMouseEnter={(e) => {
if (!confirming) {
;(e.currentTarget as HTMLElement).style.backgroundColor = '#7f1d1d'
;(e.currentTarget as HTMLElement).style.color = '#fca5a5'
}
}}
onMouseLeave={(e) => {
if (!confirming) {
;(e.currentTarget as HTMLElement).style.backgroundColor = 'var(--border)'
;(e.currentTarget as HTMLElement).style.color = 'var(--text-secondary)'
}
}}
>
{deleting
? 'Deleting…'
: confirming
? tags.length > 0
? `Confirm? (deletes ${tags.length} tag${tags.length === 1 ? '' : 's'})`
: 'Confirm?'
: 'Delete'}
</button>
</>
)}
</div>
{error && (
<p className="text-xs mb-2 px-3 py-1.5 rounded-lg" style={{ backgroundColor: '#7f1d1d33', color: '#fca5a5' }}>
{error}
</p>
)}
{/* Tags list */}
<div className="flex flex-wrap gap-2 mb-3">
{tags.map((tag) => (
<TagRow key={tag.id} tag={tag} onChanged={onChanged} />
))}
{tags.length === 0 && (
<p className="text-xs" style={{ color: 'var(--text-secondary)' }}>
No tags in this category.
</p>
)}
</div>
{/* Add tag inline */}
<AddTagForm categoryId={category.id} onAdded={onChanged} />
</div>
)
}
// ─── Tag Row ──────────────────────────────────────────────────────────────────
function TagRow({ tag, onChanged }: { tag: Tag; onChanged: () => void }) {
const [editing, setEditing] = useState(false)
const [editName, setEditName] = useState(tag.name)
const [saving, setSaving] = useState(false)
const [confirming, setConfirming] = useState(false)
const [deleting, setDeleting] = useState(false)
const cancelRef = useRef<ReturnType<typeof setTimeout> | null>(null)
const handleRename = async (e: React.FormEvent) => {
e.preventDefault()
setSaving(true)
const res = await fetch(`/api/tags/items/${encodeURIComponent(tag.id)}`, {
method: 'PATCH',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: editName }),
})
setSaving(false)
if (res.ok) { setEditing(false); onChanged() }
}
const handleDeleteClick = () => {
if (!confirming) {
setConfirming(true)
cancelRef.current = setTimeout(() => setConfirming(false), 4000)
return
}
if (cancelRef.current) clearTimeout(cancelRef.current)
setDeleting(true)
fetch(`/api/tags/items/${encodeURIComponent(tag.id)}`, { method: 'DELETE' })
.then(() => onChanged())
.catch(() => setDeleting(false))
}
if (editing) {
return (
<form onSubmit={handleRename} className="flex items-center gap-1.5">
<input
type="text"
value={editName}
onChange={(e) => setEditName(e.target.value)}
autoFocus
required
className="rounded-lg px-2 py-1 text-xs outline-none"
style={{
backgroundColor: 'var(--background)',
border: '1px solid var(--accent)',
color: 'var(--text-primary)',
width: 120,
}}
/>
<button
type="submit"
disabled={saving}
className="text-xs px-2 py-1 rounded-lg disabled:opacity-50"
style={{ backgroundColor: 'var(--accent)', color: '#fff' }}
>
{saving ? '…' : 'Save'}
</button>
<button
type="button"
onClick={() => { setEditing(false); setEditName(tag.name) }}
className="text-xs px-2 py-1 rounded-lg"
style={{ backgroundColor: 'var(--border)', color: 'var(--text-secondary)' }}
>
</button>
</form>
)
}
return (
<span
className="inline-flex items-center gap-1 px-2 py-1 rounded-full text-xs"
style={{ backgroundColor: 'var(--border)', color: 'var(--text-primary)' }}
>
{tag.name}
<button
onClick={() => { setEditing(true); setEditName(tag.name) }}
className="transition-colors"
style={{ color: 'var(--text-secondary)' }}
onMouseEnter={(e) => ((e.currentTarget as HTMLElement).style.color = 'var(--text-primary)')}
onMouseLeave={(e) => ((e.currentTarget as HTMLElement).style.color = 'var(--text-secondary)')}
title="Rename"
>
</button>
<button
onClick={handleDeleteClick}
disabled={deleting}
className="transition-colors disabled:opacity-50"
style={{ color: confirming ? '#fca5a5' : 'var(--text-secondary)' }}
onMouseEnter={(e) => ((e.currentTarget as HTMLElement).style.color = '#fca5a5')}
onMouseLeave={(e) => ((e.currentTarget as HTMLElement).style.color = confirming ? '#fca5a5' : 'var(--text-secondary)')}
title={confirming ? 'Click again to confirm delete' : 'Delete'}
>
{deleting ? '…' : '✕'}
</button>
</span>
)
}
// ─── Add Tag Form ─────────────────────────────────────────────────────────────
function AddTagForm({ categoryId, onAdded }: { categoryId: string; onAdded: () => void }) {
const [name, setName] = useState('')
const [submitting, setSubmitting] = useState(false)
const [error, setError] = useState<string | null>(null)
const handleSubmit = async (e: React.FormEvent) => {
e.preventDefault()
setError(null)
setSubmitting(true)
try {
const res = await fetch('/api/tags/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name, categoryId }),
})
const data = await res.json()
if (!res.ok) { setError(data.error); setSubmitting(false); return }
setName('')
onAdded()
} catch {
setError('Network error.')
}
setSubmitting(false)
}
return (
<form onSubmit={handleSubmit} className="flex items-center gap-2">
<input
type="text"
value={name}
onChange={(e) => setName(e.target.value)}
placeholder="New tag name…"
required
className="rounded-lg px-3 py-1.5 text-xs outline-none"
style={{
backgroundColor: 'var(--background)',
border: '1px solid var(--border)',
color: 'var(--text-primary)',
width: 160,
}}
onFocus={(e) => ((e.currentTarget as HTMLElement).style.borderColor = 'var(--accent)')}
onBlur={(e) => ((e.currentTarget as HTMLElement).style.borderColor = 'var(--border)')}
/>
<button
type="submit"
disabled={submitting}
className="text-xs px-2.5 py-1.5 rounded-lg transition-colors disabled:opacity-50"
style={{ backgroundColor: 'var(--accent)', color: '#fff' }}
>
{submitting ? 'Adding…' : '+ Add Tag'}
</button>
{error && <span className="text-xs" style={{ color: '#fca5a5' }}>{error}</span>}
</form>
)
}
// ─── Add Category Form ────────────────────────────────────────────────────────
function AddCategoryForm({ onAdded }: { onAdded: () => void }) {
const [name, setName] = useState('')
const [submitting, setSubmitting] = useState(false)
const [error, setError] = useState<string | null>(null)
const handleSubmit = async (e: React.FormEvent) => {
e.preventDefault()
setError(null)
setSubmitting(true)
try {
const res = await fetch('/api/tags/categories', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name }),
})
const data = await res.json()
if (!res.ok) { setError(data.error); setSubmitting(false); return }
setName('')
onAdded()
} catch {
setError('Network error.')
}
setSubmitting(false)
}
return (
<form onSubmit={handleSubmit} className="flex flex-col gap-4">
<Field label="Category Name">
<input
type="text"
value={name}
onChange={(e) => setName(e.target.value)}
placeholder="e.g. Genre"
required
className="w-full rounded-lg px-3 py-2 text-sm outline-none"
style={{
backgroundColor: 'var(--background)',
border: '1px solid var(--border)',
color: 'var(--text-primary)',
}}
onFocus={(e) => ((e.currentTarget as HTMLElement).style.borderColor = 'var(--accent)')}
onBlur={(e) => ((e.currentTarget as HTMLElement).style.borderColor = 'var(--border)')}
/>
</Field>
{error && (
<p className="text-sm rounded-lg px-3 py-2" style={{ backgroundColor: '#7f1d1d33', color: '#fca5a5' }}>
{error}
</p>
)}
<div>
<button
type="submit"
disabled={submitting}
className="px-4 py-2 rounded-lg text-sm font-medium transition-colors disabled:opacity-50"
style={{ backgroundColor: 'var(--accent)', color: '#fff' }}
onMouseEnter={(e) => {
if (!submitting) (e.currentTarget as HTMLElement).style.backgroundColor = 'var(--accent-hover)'
}}
onMouseLeave={(e) => {
(e.currentTarget as HTMLElement).style.backgroundColor = 'var(--accent)'
}}
>
{submitting ? 'Adding…' : 'Add Category'}
</button>
</div>
</form>
)
}
// ─── Shared helpers ───────────────────────────────────────────────────────────
function Section({ title, children }: { title: string; children: React.ReactNode }) {
return (
<div className="mb-10">
<h2
className="text-xs font-semibold uppercase tracking-wider mb-3"
style={{ color: 'var(--text-secondary)' }}
>
{title}
</h2>
<div
className="rounded-xl border"
style={{ borderColor: 'var(--border)', backgroundColor: 'var(--surface)' }}
>
<div className="px-5 py-4">{children}</div>
</div>
</div>
)
}
function Field({ label, children }: { label: string; children: React.ReactNode }) {
return (
<div className="flex flex-col gap-1.5">
<label className="text-xs font-medium" style={{ color: 'var(--text-secondary)' }}>
{label}
</label>
{children}
</div>
)
}
function LoadingRows() {
return (
<div className="flex flex-col gap-3">
{[70, 50, 85].map((w) => (
<div key={w} className="flex items-center gap-3">
<div
className="h-4 rounded animate-pulse"
style={{ width: `${w}%`, backgroundColor: 'var(--border)' }}
/>
</div>
))}
</div>
)
}