From 622cf9c26d4ea43c5275728ed57b688fd034348c Mon Sep 17 00:00:00 2001 From: tao Date: Tue, 10 Nov 2026 04:34:51 -0800 Subject: [PATCH] feat: browse source catalogs with filters and infinite scrolling --- src/app/api/catalog/route.ts | 37 ++++++++++ src/app/browse/page.tsx | 29 ++++++++ src/components/CatalogBrowser.tsx | 114 +++++++++++++++++++++++++++++ src/components/MobileBottomNav.tsx | 1 + src/components/Sidebar.tsx | 1 + src/lib/catalog-core.test.ts | 72 ++++++++++++++++++ src/lib/catalog-core.ts | 113 ++++++++++++++++++++++++++++ 7 files changed, 367 insertions(+) create mode 100644 src/app/api/catalog/route.ts create mode 100644 src/app/browse/page.tsx create mode 100644 src/components/CatalogBrowser.tsx create mode 100644 src/lib/catalog-core.test.ts create mode 100644 src/lib/catalog-core.ts diff --git a/src/app/api/catalog/route.ts b/src/app/api/catalog/route.ts new file mode 100644 index 0000000000..56f23829e6 --- /dev/null +++ b/src/app/api/catalog/route.ts @@ -0,0 +1,37 @@ +import { NextRequest, NextResponse } from 'next/server'; + +import { getAuthInfoFromCookie } from '@/lib/auth'; +import { catalogParameters, catalogQuery, loadCatalog } from '@/lib/catalog-core'; +import { API_CONFIG, getAvailableApiSites, getConfig } from '@/lib/config'; +import { yellowWords } from '@/lib/yellow'; + +export const runtime = 'nodejs'; +export async function GET(req: NextRequest) { + const auth = getAuthInfoFromCookie(req); + if (!auth?.username) return NextResponse.json({ error: 'Unauthorized' }, { status: 401 }); + try { + const sites = await getAvailableApiSites(auth.username); + const { page, category } = catalogParameters(req.nextUrl.searchParams.get('page') || 1, req.nextUrl.searchParams.get('category')); + const query = catalogQuery(req.nextUrl.searchParams.get('query')); + const key = req.nextUrl.searchParams.get('source'); + if (!key) return NextResponse.json({ sources: sites.map(s => ({ id: s.key, name: s.name })) }, { headers: { 'Cache-Control': 'private, no-store' } }); + const source = sites.find(s => s.key === key); + if (!source) return NextResponse.json({ error: '点播源不存在或无访问权限' }, { status: 404 }); + const config = await getConfig(); + const filtered = !config.SiteConfig.DisableYellowFilter; + const data = await loadCatalog(source.api, page, category, name => filtered && yellowWords.some(word => name.includes(word)), async url => { + // Only a server-configured, user-authorized source can be requested; reject redirects. + const controller = new AbortController(), timer = setTimeout(() => controller.abort(), 10000); + const abort = () => controller.abort(); req.signal.addEventListener('abort', abort, { once: true }); + try { + const res = await fetch(url, { headers: API_CONFIG.search.headers, signal: controller.signal, redirect: 'error', cache: 'no-store' }); + if (!res.ok) throw new Error(`点播源暂时不可用(HTTP ${res.status})`); + return await res.json(); + } finally { clearTimeout(timer); req.signal.removeEventListener('abort', abort); } + }, query); + return NextResponse.json(data, { headers: { 'Cache-Control': 'private, no-store' } }); + } catch (e) { + const message = e instanceof Error ? e.message : '目录加载失败'; + return NextResponse.json({ error: message }, { status: message.startsWith('无效') ? 400 : 502 }); + } +} diff --git a/src/app/browse/page.tsx b/src/app/browse/page.tsx new file mode 100644 index 0000000000..7a1befd703 --- /dev/null +++ b/src/app/browse/page.tsx @@ -0,0 +1,29 @@ +'use client'; + +import { useSearchParams } from 'next/navigation'; +import { Suspense, useCallback, useEffect, useState } from 'react'; + +import type { CatalogPage } from '@/lib/catalog-core'; + +import CatalogBrowser from '@/components/CatalogBrowser'; +import PageLayout from '@/components/PageLayout'; +import VideoCard from '@/components/VideoCard'; + +function BrowseContent() { + const params = useSearchParams(); + const [sources, setSources] = useState<{ id: string; name: string }[]>([]), [error, setError] = useState(''), [attempt, setAttempt] = useState(0), [ready, setReady] = useState(false); + useEffect(() => { + const controller = new AbortController(); setError(''); setReady(false); + fetch('/api/catalog', { signal: controller.signal }).then(async res => { const data = await res.json(); if (!res.ok) throw new Error(data.error || '点播源加载失败'); return data.sources; }) + .then(data => { if (!controller.signal.aborted) { setSources(data); setReady(true); } }).catch(e => { if (!controller.signal.aborted) setError(e.message); }); + return () => controller.abort(); + }, [attempt]); + const fetchPage = useCallback(async (source: string, category: string, page: number, signal: AbortSignal, query: string): Promise => { + const res = await fetch('/api/catalog?' + new URLSearchParams({ source, category, page: String(page), query }), { signal }); + const data = await res.json(); if (!res.ok) throw new Error(data.error || '目录加载失败'); return data; + }, []); + return
+ {error ?

{error}

: !ready ?

正在加载点播源...

: s.id === source)?.name} />} />} +
; +} +export default function BrowsePage() { return ; } diff --git a/src/components/CatalogBrowser.tsx b/src/components/CatalogBrowser.tsx new file mode 100644 index 0000000000..fb3374ece3 --- /dev/null +++ b/src/components/CatalogBrowser.tsx @@ -0,0 +1,114 @@ +'use client'; + +import { ReactNode, useCallback, useEffect, useMemo, useRef, useState } from 'react'; + +import { appendCatalog, catalogFacets, CatalogFilters, CatalogItem, CatalogPage, CatalogSort, matchesCatalog, selectCatalogItems } from '@/lib/catalog-core'; + +interface Props { + sources: { id: string; name: string }[]; + fetchPage: (source: string, category: string, page: number, signal: AbortSignal, query: string) => Promise; + renderCard: (item: CatalogItem, source: string) => ReactNode; + initialSource?: string; initialCategory?: string; initialQuery?: string; +} +interface State { key: string; data?: CatalogPage; items: CatalogItem[]; next: number | null; loading: boolean; error: string; emptyPages: number; } +const empty: State = { key: '', items: [], next: 1, loading: false, error: '', emptyPages: 0 }; + +export default function CatalogBrowser({ sources, fetchPage, renderCard, initialSource = '', initialCategory = '', initialQuery = '' }: Props) { + const [chosen, setChosen] = useState(initialSource), [category, setCategory] = useState(initialCategory); + const [query, setQuery] = useState(initialQuery), [draft, setDraft] = useState(initialQuery); + const [filters, setFilters] = useState({ year: '', language: '', region: '' }); + const [sort, setSort] = useState('source'); + const filterRef = useRef(filters); filterRef.current = filters; + const source = sources.some(s => s.id === chosen) ? chosen : sources[0]?.id || ''; + const key = JSON.stringify([source, category, query]); + const [state, setState] = useState(empty); + const request = useRef<{ controller: AbortController } | null>(null); + const more = useRef(null); + const visible = state.key === key ? state : empty; + const facets = useMemo(() => catalogFacets(visible.items), [visible.items]); + const displayed = useMemo(() => selectCatalogItems(visible.items, filters, sort), [visible.items, filters, sort]); + const hasFilters = Boolean(filters.year || filters.language || filters.region); + useEffect(() => { setFilters({ year: '', language: '', region: '' }); }, [key]); + useEffect(() => { setState(s => ({ ...s, emptyPages: 0 })); }, [filters]); + + const load = useCallback(async (page: number, reset = false) => { + if (!source || (!reset && request.current)) return; + if (reset) request.current?.controller.abort(); + const current = { controller: new AbortController() }; request.current = current; + setState(s => ({ ...(reset || s.key !== key ? empty : s), key, loading: true, error: '' })); + try { + const data = await fetchPage(source, category, page, current.controller.signal, query); + if (request.current !== current || current.controller.signal.aborted) return; + setState(s => { + const before = reset || s.key !== key ? [] : s.items; + const merged = appendCatalog(before, data); + return { key, data, ...merged, next: merged.nextPage, loading: false, error: '', emptyPages: !data.items.some(i => matchesCatalog(i, filterRef.current)) && data.nextPage ? (reset || s.key !== key ? 0 : s.emptyPages) + 1 : 0 }; + }); + } catch (e) { + if (request.current !== current || current.controller.signal.aborted) return; + setState(s => ({ ...s, loading: false, error: e instanceof Error ? e.message : '目录加载失败' })); + } finally { if (request.current === current) request.current = null; } + }, [source, category, query, key, fetchPage]); + + useEffect(() => { + void load(1, true); + if (source) { + const url = new URL(window.location.href); url.searchParams.set('source', source); + if (category) url.searchParams.set('category', category); else url.searchParams.delete('category'); + if (query) url.searchParams.set('query', query); else url.searchParams.delete('query'); + window.history.replaceState(window.history.state, '', url); + } + return () => { request.current?.controller.abort(); request.current = null; }; + }, [load, source, category, query]); + + useEffect(() => { + const target = more.current; + if (!target || !visible.data || visible.loading || visible.error || !visible.next || visible.emptyPages >= 3 || typeof IntersectionObserver === 'undefined') return; + const observer = new IntersectionObserver(entries => { + if (entries.some(e => e.isIntersecting)) void load(visible.next as number); + }, { rootMargin: '600px 0px' }); + observer.observe(target); return () => observer.disconnect(); + }, [visible.data, visible.loading, visible.error, visible.next, visible.emptyPages, load]); + + const control = 'w-full rounded-lg border border-gray-400 px-3 py-2 bg-white text-gray-900 dark:bg-gray-800 dark:text-gray-100'; + const button = 'rounded-lg border border-gray-400 px-4 py-2 hover:bg-gray-500/10 focus-visible:outline focus-visible:outline-2 focus-visible:outline-cyan-500'; + return
+

浏览源

+

选择点播源,按分类浏览内容

+ {sources.length === 0 ?

暂无可用点播源,请在设置中启用点播源。

: <> +
+ + +
+
{ e.preventDefault(); setQuery(draft.trim().slice(0, 100)); }}> + setDraft(e.target.value)} /> + + {query && } +
+

片名搜索查询源站目录;以下筛选和排序作用于已加载内容。

+
+ {([['year', '年份', facets.years], ['language', '语言', facets.languages], ['region', '地区', facets.regions]] as const).map(([field, label, options]) => )} + +
+ {visible.data?.categoryWarning &&

{visible.data.categoryWarning}

} +

已加载 {visible.items.length} 部{hasFilters && ` · 筛选后 ${displayed.length} 部`}

+
+ {displayed.map(item =>
{renderCard(item, source)}
)} +
+
+ {visible.loading ?

正在加载目录...

: visible.error ?

{visible.error}

{category && }
: !visible.data ?

正在准备目录...

: visible.next ? <> + {visible.emptyPages >= 3 &&

当前页暂无可显示内容,可继续查看下一页。

} + + :

{visible.items.length ? (hasFilters ? `已加载 ${visible.items.length} 部,筛选后 ${displayed.length} 部` : `已显示全部 ${visible.items.length} 部`) : '该分类暂无内容'}

} +
+ } +
; +} diff --git a/src/components/MobileBottomNav.tsx b/src/components/MobileBottomNav.tsx index 3932ec3213..854181b7bb 100644 --- a/src/components/MobileBottomNav.tsx +++ b/src/components/MobileBottomNav.tsx @@ -22,6 +22,7 @@ const MobileBottomNav = ({ activePath }: MobileBottomNavProps) => { const [navItems, setNavItems] = useState([ { icon: Home, label: '首页', href: '/' }, + { icon: Film, label: '浏览源', href: '/browse' }, { icon: Film, label: '电影', diff --git a/src/components/Sidebar.tsx b/src/components/Sidebar.tsx index 2160df0e0b..7858b4a76c 100644 --- a/src/components/Sidebar.tsx +++ b/src/components/Sidebar.tsx @@ -125,6 +125,7 @@ const Sidebar = ({ onToggle, activePath = '/' }: SidebarProps) => { }; const [menuItems, setMenuItems] = useState([ + { icon: Film, label: '浏览源', href: '/browse' }, { icon: Film, label: '电影', diff --git a/src/lib/catalog-core.test.ts b/src/lib/catalog-core.test.ts new file mode 100644 index 0000000000..f2d228877c --- /dev/null +++ b/src/lib/catalog-core.test.ts @@ -0,0 +1,72 @@ +import { appendCatalog, catalogFacets, catalogParameters, catalogQuery, catalogUrl, loadCatalog, matchesCatalog, parseCatalog, selectCatalogItems } from './catalog-core'; +const item = (id: number, type = 1) => ({ vod_id: id, vod_name: 'Film ' + id, type_id: type, vod_pic: 'https://images.example/' + id + '.jpg' }); +const metadata = { class: [{ type_id: 1, type_name: 'Movies' }, { type_id: 2, type_name: 'Hidden' }, { type_id: 3, type_pid: 2, type_name: 'Child' }] }; +const block = (s: string) => s === 'Hidden'; +const page = (ids: number[], n = 1, pagecount = 4) => parseCatalog({ list: ids.map(id => item(id)), page: n, pagecount }, metadata, n, '', block); +describe('source catalog protocol and filtering', () => { + it('rejects invalid page/category inputs before issuing a request', () => { + for (const p of [0, -1, 1.5, 'abc', 100001]) expect(() => catalogParameters(p, '')).toThrow(); + for (const c of ['1&ids=9', '-1', 'xyz']) expect(() => catalogParameters(1, c)).toThrow(); + expect(catalogParameters(2, '10')).toEqual({ page: 2, category: '10' }); + }); + it('preserves configured parameters while removing inherited search/detail filters', () => { + const url = new URL(catalogUrl('https://example.com/api?token=public&wd=old&ids=5&t=4', 2, '8')); + expect(url.searchParams.get('token')).toBe('public'); expect(url.searchParams.has('wd')).toBe(false); expect(url.searchParams.has('ids')).toBe(false); + expect(url.searchParams.get('t')).toBe('8'); expect(url.searchParams.get('pg')).toBe('2'); expect(() => catalogUrl('https://user:password@example.com', 1, '')).toThrow(); + }); + it('hides blocked categories, their children and matching videos', () => { + const data = parseCatalog({ list: [item(1), item(2, 2), item(3, 3)] }, metadata, 1, '', block); + expect(data.categories).toEqual([{ id: '1', name: 'Movies' }]); expect(data.items.map(i => i.id)).toEqual(['1']); expect(() => parseCatalog({ list: [] }, metadata, 1, '3', block)).toThrow(); + }); + it('rejects malformed responses and unsafe or incomplete cards', () => { + expect(() => parseCatalog({ list: 'bad' }, {}, 1, '', block)).toThrow(); + const data = parseCatalog({ list: [item(1), item(1), { vod_id: 'bad/id', vod_name: 'Bad' }, { vod_id: 8 }, { ...item(2), vod_pic: 'javascript:alert(1)' }] }, {}, 1, '', block); + expect(data.items.map(i => i.id)).toEqual(['1', '2']); expect(data.items[1].poster).toBe(''); + }); + it('stops empty/last pages and wrong reported pages; tolerates absent totals', () => { + expect(page([], 2).nextPage).toBeNull(); expect(page([1], 4).nextPage).toBeNull(); + expect(parseCatalog({ list: [item(1)], page: 1 }, {}, 2, '', block).nextPage).toBeNull(); expect(parseCatalog({ list: [item(1)] }, {}, 1, '', block).nextPage).toBe(2); + }); + it('preserves metadata/order, merges overlap and stops fully repeated pages', () => { + const first = page([1, 2]), second = page([2, 3], 2); second.items[0].title = 'Changed'; + const merged = appendCatalog(first.items, second); expect(merged.items.map(i => i.id)).toEqual(['1', '2', '3']); expect(merged.items[1].title).toBe('Film 2'); expect(merged.nextPage).toBe(3); expect(appendCatalog(first.items, page([2, 1], 2)).nextPage).toBeNull(); + }); + it('does not falsely stop when all records on a page are filtered', () => { + const filtered = parseCatalog({ list: [item(1, 2)], pagecount: 3 }, metadata, 1, '', block); expect(filtered.items).toEqual([]); expect(filtered.rawCount).toBe(1); expect(appendCatalog([], filtered).nextPage).toBe(2); + }); + it('keeps lists when metadata fails, with separately cached pages', async () => { + let calls = 0; const base = 'https://cache-fixture.example/api'; + const fetcher = async (url: string) => { calls++; if (new URL(url).searchParams.get('ac') === 'list') throw new Error('metadata outage'); return { list: [item(Number(new URL(url).searchParams.get('pg')))], pagecount: 3 }; }; + expect((await loadCatalog(base, 1, '', block, fetcher)).categoryWarning).toBeTruthy(); await loadCatalog(base, 1, '', block, fetcher); expect(calls).toBe(3); + expect((await loadCatalog(base, 2, '', block, fetcher)).items[0].id).toBe('2'); expect(calls).toBe(5); + }); +}); + +// Loaded-item views must never mutate the source order used for pagination. +const filters = { year: '', language: '', region: '' }; +const records = [ + { id: 'a', title: 'Zebra', poster: '', year: '2024', remarks: '', languages: ['English'], regions: ['US'], updatedAt: '2026-01-01 00:00:00' }, + { id: 'b', title: 'Alpha', poster: '', year: '2026', remarks: '', languages: ['中文', 'English'], regions: ['中国'], updatedAt: '2026-02-01 00:00:00' }, + { id: 'c', title: 'Beta', poster: '', year: '', remarks: '' }, +]; +it('sorts only loaded records without changing pagination order, with missing metadata last', () => { + expect(selectCatalogItems(records, filters, 'title-asc').map(i => i.id)).toEqual(['b', 'c', 'a']); + expect(selectCatalogItems(records, filters, 'year-desc').map(i => i.id)).toEqual(['b', 'a', 'c']); + expect(selectCatalogItems(records, filters, 'year-asc').map(i => i.id)).toEqual(['a', 'b', 'c']); + expect(selectCatalogItems(records, filters, 'updated-desc').map(i => i.id)).toEqual(['b', 'a', 'c']); + expect(records.map(i => i.id)).toEqual(['a', 'b', 'c']); +}); +it('combines exact loaded year/language/region filters and derives options from real metadata', () => { + expect(selectCatalogItems(records, { year: '2026', language: 'English', region: '中国' }, 'source').map(i => i.id)).toEqual(['b']); + expect(matchesCatalog(records[2], { ...filters, language: 'English' })).toBe(false); + expect(catalogFacets(records)).toEqual({ years: ['2026', '2024'], languages: ['中文', 'English'], regions: ['中国', 'US'] }); +}); +it('encodes title searches safely and excludes keywords from the category request', () => { + expect(catalogQuery(' hello ')).toBe('hello'); expect(() => catalogQuery('x'.repeat(101))).toThrow(); + expect(new URL(catalogUrl('https://example.com/api', 2, '1', false, 'A&B')).searchParams.get('wd')).toBe('A&B'); + expect(new URL(catalogUrl('https://example.com/api', 1, '', true, 'A&B')).searchParams.has('wd')).toBe(false); +}); +it('normalizes multi-valued language and region metadata without inventing missing values', () => { + const parsed = parseCatalog({ list: [{ ...item(1), vod_lang: '中文 / English', vod_area: '中国, US' }] }, {}, 1, '', block); + expect(parsed.items[0].languages).toEqual(['中文', 'English']); expect(parsed.items[0].regions).toEqual(['中国', 'US']); +}); diff --git a/src/lib/catalog-core.ts b/src/lib/catalog-core.ts new file mode 100644 index 0000000000..0ec043a033 --- /dev/null +++ b/src/lib/catalog-core.ts @@ -0,0 +1,113 @@ +export interface CatalogCategory { id: string; name: string; } +export interface CatalogItem { id: string; title: string; poster: string; year: string; remarks: string; languages?: string[]; regions?: string[]; updatedAt?: string; } +export interface CatalogPage { + items: CatalogItem[]; categories: CatalogCategory[]; page: number; + nextPage: number | null; rawCount: number; categoryWarning?: string; +} +type Row = Record; +const row = (v: unknown): Row => v !== null && typeof v === 'object' ? v as Row : {}; +const text = (v: unknown) => (typeof v === 'string' || typeof v === 'number' ? String(v).trim() : '').slice(0, 1000); +const validId = (v: string) => /^[\w-]{1,100}$/.test(v); + +export function catalogParameters(page: unknown, category: unknown) { + const p = Number(page ?? 1), c = text(category); + if (!Number.isInteger(p) || p < 1 || p > 100000 || (c !== '' && !/^\d{1,10}$/.test(c))) throw new Error('无效的目录页码或分类'); + return { page: p, category: c }; +} + +export function catalogUrl(base: string, page: number, category: string, metadata = false, query = '') { + const url = new URL(base); + if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password) throw new Error('无效的点播源地址'); + for (const key of ['wd', 'ids', 't', 'pg']) url.searchParams.delete(key); + url.searchParams.set('ac', metadata ? 'list' : 'videolist'); + url.searchParams.set('pg', String(page)); + if (category) url.searchParams.set('t', category); + if (query && !metadata) url.searchParams.set('wd', catalogQuery(query)); + return url.href; +} + +export function parseCatalog(data: unknown, metadata: unknown, page: number, category: string, blocked: (name: string) => boolean): CatalogPage { + const d = row(data), m = row(metadata); + if (!Array.isArray(d.list)) throw new Error('该源未返回可浏览的目录,请稍后重试或更换点播源'); + const classes = (Array.isArray(m.class) ? m.class : []).slice(0, 1000).map(row); + const forbidden = new Set(classes.filter(c => blocked(text(c.type_name))).map(c => text(c.type_id))); + // A blocked parent also blocks its children even when the child name is neutral. + for (let i = 0; i < classes.length; i++) { + let changed = false; + for (const c of classes) if (forbidden.has(text(c.type_pid)) && !forbidden.has(text(c.type_id))) { forbidden.add(text(c.type_id)); changed = true; } + if (!changed) break; + } + if (category && forbidden.has(category)) throw new Error('此分类已被内容过滤隐藏'); + const names = new Map(classes.map(c => [text(c.type_id), text(c.type_name)])); + const categories: CatalogCategory[] = [], seenCategories = new Set(); + for (const c of classes) { + const id = text(c.type_id), name = text(c.type_name); + if (/^\d{1,10}$/.test(id) && name && !forbidden.has(id) && !seenCategories.has(id)) { categories.push({ id, name }); seenCategories.add(id); } + } + const raw = d.list.slice(0, 1000).map(row), items: CatalogItem[] = [], seen = new Set(); + for (const v of raw) { + const id = text(v.vod_id), title = text(v.vod_name), type = text(v.type_id); + if (!validId(id) || !title || seen.has(id) || forbidden.has(type) || blocked(text(v.type_name) || names.get(type) || '')) continue; + seen.add(id); + let poster = ''; + try { const u = new URL(text(v.vod_pic)); if (['http:', 'https:'].includes(u.protocol)) poster = u.href; } catch { /* a missing cover uses the normal placeholder */ } + items.push({ id, title, poster, year: text(v.vod_year), remarks: text(v.vod_remarks), languages: text(v.vod_lang).split(/[/,,、|]+/u).map(s => s.trim()).filter(Boolean), regions: text(v.vod_area).split(/[/,,、|]+/u).map(s => s.trim()).filter(Boolean), updatedAt: text(v.vod_time) }); + } + const pages = Number(d.pagecount), reported = Number(d.page); + const atEnd = raw.length === 0 || (Number.isFinite(pages) && pages > 0 && page >= pages) || (Number.isFinite(reported) && reported > 0 && reported !== page) || page >= 100000; + return { items, categories, page, nextPage: atEnd ? null : page + 1, rawCount: raw.length }; +} + +export function appendCatalog(previous: CatalogItem[], incoming: CatalogPage) { + const seen = new Set(previous.map(i => i.id)); + const additions = incoming.items.filter(i => { if (seen.has(i.id)) return false; seen.add(i.id); return true; }); + return { items: [...previous, ...additions], nextPage: incoming.items.length > 0 && additions.length === 0 ? null : incoming.nextPage }; +} + +const cache = new Map(); +async function cached(key: string, ttl: number, fetcher: () => Promise) { + const hit = cache.get(key); + if (hit && hit.until > Date.now()) return hit.data; + const data = await fetcher(); + if (cache.size >= 200) cache.delete(cache.keys().next().value as string); + cache.set(key, { until: Date.now() + ttl, data }); + return data; +} +export async function loadCatalog(base: string, page: number, category: string, blocked: (name: string) => boolean, fetchJson: (url: string) => Promise, query = ''): Promise { + let metadata: unknown = {}, warning: string | undefined; + try { metadata = await cached('meta:' + base, 300000, () => fetchJson(catalogUrl(base, 1, '', true))); } + catch { warning = '分类暂时不可用,仍可浏览全部内容'; } + const url = catalogUrl(base, page, category, false, query); + const data = await cached('page:' + url, 60000, () => fetchJson(url)); + const result = parseCatalog(data, metadata, page, category, blocked); + if (warning || !result.categories.length) result.categoryWarning = warning || '该源未提供分类,可浏览全部内容'; + return result; +} + +export interface CatalogFilters { year: string; language: string; region: string; } +export type CatalogSort = 'source' | 'title-asc' | 'title-desc' | 'year-desc' | 'year-asc' | 'updated-desc' | 'updated-asc'; +export function catalogQuery(value: unknown): string { + if (value === undefined || value === null) return ''; + if (typeof value !== 'string' || value.trim().length > 100) throw new Error('无效的片名搜索条件'); + return value.trim(); +} +export function catalogYear(item: CatalogItem) { return item.year?.match(/\d{4}/)?.[0] || ''; } +export function matchesCatalog(item: CatalogItem, filters: CatalogFilters) { + return (!filters.year || catalogYear(item) === filters.year) && (!filters.language || (item.languages || []).includes(filters.language)) && (!filters.region || (item.regions || []).includes(filters.region)); +} +export function catalogFacets(items: CatalogItem[]) { + const collect = (values: string[]) => Array.from(new Set(values.filter(Boolean))).sort((a, b) => a.localeCompare(b, 'zh-CN')); + return { years: collect(items.map(catalogYear)).reverse(), languages: collect(items.flatMap(i => i.languages || [])), regions: collect(items.flatMap(i => i.regions || [])) }; +} +export function selectCatalogItems(items: CatalogItem[], filters: CatalogFilters, sort: CatalogSort): CatalogItem[] { + const result = items.filter(i => matchesCatalog(i, filters)); + if (sort === 'source') return result; + const direction = sort.endsWith('asc') ? 1 : -1; + const updated = (i: CatalogItem) => { const value = i.updatedAt || ''; const n = /^\d{10,13}$/.test(value) ? Number(value) * (value.length === 10 ? 1000 : 1) : Date.parse(value.replace(' ', 'T')); return Number.isFinite(n) ? n : undefined; }; + return result.sort((a, b) => { + if (sort.startsWith('title')) return direction * a.title.localeCompare(b.title, 'zh-CN', { numeric: true }); + const x = sort.startsWith('year') ? Number(catalogYear(a)) || undefined : updated(a), y = sort.startsWith('year') ? Number(catalogYear(b)) || undefined : updated(b); + if (x === undefined) return y === undefined ? 0 : 1; if (y === undefined) return -1; + return direction * (x - y); + }); +}