v3: added site-wide categories, added admin category management, various visual fixes

api/model/interfaces.ts

@@ -33,6 +33,54 @@ export interface Dump {
   commentCount: number;
   isPrivate: boolean;
   thumbnailMime?: string;
+  categoryIds?: string[];
+}
+
+/**
+ * Categories
+ */
+
+export interface Category {
+  id: string;
+  slug: string;
+  name: string;
+  position: number;
+  createdAt: Date;
+  updatedAt?: Date;
+}
+
+export interface CreateCategoryRequest {
+  slug: string;
+  name: string;
+  position?: number;
+}
+
+export interface UpdateCategoryRequest {
+  slug?: string;
+  name?: string;
+  position?: number;
+}
+
+export function isCreateCategoryRequest(
+  obj: unknown,
+): obj is CreateCategoryRequest {
+  if (!obj || typeof obj !== "object") return false;
+  const o = obj as Record<string, unknown>;
+  if (typeof o.slug !== "string") return false;
+  if (typeof o.name !== "string") return false;
+  if ("position" in o && typeof o.position !== "number") return false;
+  return true;
+}
+
+export function isUpdateCategoryRequest(
+  obj: unknown,
+): obj is UpdateCategoryRequest {
+  if (!obj || typeof obj !== "object") return false;
+  const o = obj as Record<string, unknown>;
+  if ("slug" in o && typeof o.slug !== "string") return false;
+  if ("name" in o && typeof o.name !== "string") return false;
+  if ("position" in o && typeof o.position !== "number") return false;
+  return true;
 }
 
 /**
@@ -390,10 +438,15 @@ export function isReorderPlaylistRequest(
  * Request DTOs
  */
 
+function isStringArray(value: unknown): value is string[] {
+  return Array.isArray(value) && value.every((v) => typeof v === "string");
+}
+
 export interface CreateUrlDumpRequest {
   url: string;
   comment?: string;
   isPrivate?: boolean;
+  categoryIds?: string[];
 }
 
 export function isCreateUrlDumpRequest(
@@ -412,6 +465,7 @@ export function isCreateUrlDumpRequest(
     (o.comment as string).length > VALIDATION.DUMP_COMMENT_MAX
   ) return false;
   if ("isPrivate" in o && typeof o.isPrivate !== "boolean") return false;
+  if ("categoryIds" in o && !isStringArray(o.categoryIds)) return false;
   return true;
 }
 
@@ -420,6 +474,7 @@ export interface UpdateDumpRequest {
   title?: string;
   comment?: string;
   isPrivate?: boolean;
+  categoryIds?: string[];
 }
 
 export function isUpdateDumpRequest(obj: unknown): obj is UpdateDumpRequest {
@@ -439,6 +494,7 @@ export function isUpdateDumpRequest(obj: unknown): obj is UpdateDumpRequest {
     (o.comment as string).length > VALIDATION.DUMP_COMMENT_MAX
   ) return false;
   if ("isPrivate" in o && typeof o.isPrivate !== "boolean") return false;
+  if ("categoryIds" in o && !isStringArray(o.categoryIds)) return false;
   return true;
 }