v4: playlists have categories of their own — a set apart from the dumps', which admins manage on /manage under "Playlist categories", next to "Dump categories". Each category now has a kind, dump or playlist, its slug and name unique within its kind only; migration 0025 rebuilds categories with the column, every existing one becoming a dump category with its dumps, and adds playlist_categories. A playlist's owner files it under any of them in the create and edit forms, and it shows them as chips on its card and its page, each leading to /playlists/<slug>.

/playlists is the new page of every public playlist, newest first (GET /api/playlists), and /playlists/<slug> a playlist category's, with a menu of the categories, linked from the user menu as "All playlists"; `playlists` is reserved as a dump category's slug, and one that had it is renamed. A profile's Playlists tab narrows to a playlist category with the same menu as its Dumps tab (?category=), and so do the Dumps and Playlists tabs of /search, each with its own kind (category and playlistCategory for GET /api/search), another tab dropping it.

The category service takes the kind throughout, so a dump can't be filed under a playlist category nor the other way round, and categoryJoin is the one filter join the dump, follow and playlist services share. useCategories(kind) gives one kind's set from the one fetch, CategoryChips replaces the chips the dump card and page each drew, useCategoryFilter keeps a list to its category as the socket brings more, and useCategorySelection holds a form's picked categories.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
khannurien
2026-10-09 21:53:16 +00:00
parent 681170a517
commit 53515ce46f
71 changed files with 2166 additions and 705 deletions

View File

@@ -5,9 +5,10 @@
* @module
*/
import type {
CreateCategoryRequest,
UpdateCategoryRequest,
import {
type CreateCategoryRequest,
isCategoryKind,
type UpdateCategoryRequest,
} from "../../shared/category.ts";
/** Checks whether `obj` has the fields of a {@link CreateCategoryRequest}. */
@@ -16,6 +17,7 @@ export function isCreateCategoryRequest(
): obj is CreateCategoryRequest {
if (!obj || typeof obj !== "object") return false;
const o = obj as Record<string, unknown>;
if (!isCategoryKind(o.kind)) return false;
if (typeof o.slug !== "string") return false;
if (typeof o.name !== "string") return false;
if ("position" in o && typeof o.position !== "number") return false;

View File

@@ -11,6 +11,13 @@ import type {
} from "../../shared/playlist.ts";
import { VALIDATION } from "../../shared/validation.ts";
/** Checks that `categoryIds`, when `o` has it, is a list of strings. */
function hasValidCategoryIds(o: Record<string, unknown>): boolean {
return !("categoryIds" in o) ||
(Array.isArray(o.categoryIds) &&
o.categoryIds.every((id) => typeof id === "string"));
}
/** Checks that `title` isn't blank and, trimmed, fits the limit. */
function isValidTitle(title: string): boolean {
const trimmed = title.trim();
@@ -20,7 +27,8 @@ function isValidTitle(title: string): boolean {
/**
* Checks whether `obj` is a {@link CreatePlaylistRequest} with a title that
* isn't blank, and a title and description within the `VALIDATION` limits. A
* null description passes.
* null description passes. Whether its category ids name playlist categories
* is the playlist service's to check.
*/
export function isCreatePlaylistRequest(
obj: unknown,
@@ -40,7 +48,7 @@ export function isCreatePlaylistRequest(
typeof o.description === "string" &&
(o.description as string).length > VALIDATION.PLAYLIST_DESCRIPTION_MAX
) return false;
return true;
return hasValidCategoryIds(o);
}
/**
@@ -68,7 +76,7 @@ export function isUpdatePlaylistRequest(
(o.description as string).length > VALIDATION.PLAYLIST_DESCRIPTION_MAX
) return false;
if ("isPublic" in o && typeof o.isPublic !== "boolean") return false;
return true;
return hasValidCategoryIds(o);
}
/**