@itsmrtr/bunkoshelf 1.14.1 → 1.16.0

package/dist/src/lib/db/library.ts

@@ -6,6 +6,8 @@ import {
 } from "@/lib/librarySection";
 import { MANGA_LIBRARY_TAG } from "@/lib/mangaLibraryCache";
 import { query, queryOne } from "./query";
+import { getCurrentContentVisibilityPolicy } from "@/lib/parentalControlServer";
+import { canViewAgeRating, type ContentVisibilityPolicy } from "@/lib/parentalControl";
 
 export interface GenreFilter {
   id: string;
@@ -147,6 +149,7 @@ interface FindSeriesOptions {
 }
 
 export interface SeriesVolumeAggregate {
+  ageRating: string | null;
   communityRating: number | null;
   format: string | null;
   id: string;
@@ -677,6 +680,9 @@ export async function listPagedCatalogLibraryVolumes(
   options?: PagedQueryOptions & { userId?: string | null }
 ): Promise<PaginatedResult<CatalogLibraryVolume>> {
   const pagination = buildPagination(options);
+  const policy = await getCurrentContentVisibilityPolicy();
+  const catalogLimit = policy.enabled ? 50_000 : pagination.pageSize;
+  const catalogOffset = policy.enabled ? 0 : pagination.offset;
 
   const [countRow, rows] = await Promise.all([
     queryOne<{ total: string | number }>(
@@ -790,19 +796,22 @@ export async function listPagedCatalogLibraryVolumes(
         LIMIT $2
         OFFSET $3
       `,
-      [options?.userId ?? null, pagination.pageSize, pagination.offset]
+      [options?.userId ?? null, catalogLimit, catalogOffset]
     ),
   ]);
 
   const total = parseCount(countRow?.total ?? 0);
 
-  return mapPaginatedResult(
-    rows.map((row) => ({
+  const items: CatalogLibraryVolume[] = rows.filter((row) => canViewAgeRating(
+    row.age_rating,
+    row.library_section === "books" ? "book" : "manga",
+    policy
+  )).map((row) => ({
       id: row.id,
       slug: row.slug,
-      section: row.library_section === "books"
+      section: (row.library_section === "books"
         ? "books"
-        : getLibrarySection(row.library_section),
+        : getLibrarySection(row.library_section)) as CatalogLibraryVolume["section"],
       title: row.title,
       series: row.series,
       number: row.number,
@@ -814,8 +823,13 @@ export async function listPagedCatalogLibraryVolumes(
       gtin: row.gtin,
       isRead: row.is_read === true,
       isFavorite: row.is_favorite === true,
-    })),
-    total,
+    }));
+
+  return mapPaginatedResult(
+    policy.enabled
+      ? items.slice(pagination.offset, pagination.offset + pagination.pageSize)
+      : items,
+    policy.enabled ? items.length : total,
     pagination
   );
 }
@@ -1364,11 +1378,10 @@ async function listVolumesCached(options: SharedVolumeQueryOptions = {}) {
 export async function listVolumes(
   options?: VolumeQueryOptions
 ): Promise<LibraryVolume[]> {
-  if (options?.userId || options?.onlyUnreadForUser) {
-    return listVolumesRaw(options);
-  }
-
-  return listVolumesCached({
+  const policy = await getCurrentContentVisibilityPolicy();
+  const result = options?.userId || options?.onlyUnreadForUser
+    ? await listVolumesRaw(options)
+    : await listVolumesCached({
     includeGenres: options?.includeGenres,
     includeTags: options?.includeTags,
     authorNames: options?.authorNames,
@@ -1377,7 +1390,12 @@ export async function listVolumes(
     seriesIds: options?.seriesIds,
     volumeIds: options?.volumeIds,
     scope: options?.scope,
-  });
+    });
+  return filterVisibleVolumes(result, policy);
+}
+
+function filterVisibleVolumes(volumes: LibraryVolume[], policy: ContentVisibilityPolicy): LibraryVolume[] {
+  return volumes.filter((volume) => canViewAgeRating(volume.metadataObj?.ageRating, "manga", policy));
 }
 
 async function listPagedVolumeIdsRaw(
@@ -1451,6 +1469,23 @@ export async function listPagedVolumes(
       includeTags?: boolean;
     }
 ): Promise<PaginatedResult<LibraryVolume>> {
+  const policy = await getCurrentContentVisibilityPolicy();
+  if (policy.enabled) {
+    const all = await listVolumes({
+      includeGenres: options?.includeGenres,
+      includeTags: options?.includeTags,
+      authorNames: options?.authorNames,
+      genreNames: options?.genreNames,
+      tagNames: options?.tagNames,
+      seriesIds: options?.seriesIds,
+      volumeIds: options?.volumeIds,
+      userId: options?.userId,
+      onlyUnreadForUser: options?.onlyUnreadForUser,
+      scope: options?.scope,
+    });
+    const pagination = buildPagination(options);
+    return mapPaginatedResult(all.slice(pagination.offset, pagination.offset + pagination.pageSize), all.length, pagination);
+  }
   const pagedIds = options?.userId || options?.onlyUnreadForUser
     ? await listPagedVolumeIdsRaw(options)
     : await listPagedVolumeIdsCached({
@@ -1600,7 +1635,8 @@ async function listSeriesWithVolumesCached(
 export async function listSeriesWithVolumes(
   options?: SharedSeriesQueryOptions
 ): Promise<LibrarySeriesWithVolumes[]> {
-  return listSeriesWithVolumesCached({
+  const policy = await getCurrentContentVisibilityPolicy();
+  const series = await listSeriesWithVolumesCached({
     authorNames: options?.authorNames,
     genreNames: options?.genreNames,
     tagNames: options?.tagNames,
@@ -1609,6 +1645,7 @@ export async function listSeriesWithVolumes(
     includeTags: options?.includeTags,
     scope: options?.scope,
   });
+  return series.map((entry) => ({ ...entry, volumes: filterVisibleVolumes(entry.volumes, policy) })).filter((entry) => entry.volumes.length > 0);
 }
 
 async function listPagedSeriesIdsRaw(
@@ -1689,6 +1726,20 @@ export async function listPagedSeriesWithVolumes(
       excludeOneshots?: boolean;
     }
 ): Promise<PaginatedResult<LibrarySeriesWithVolumes>> {
+  const policy = await getCurrentContentVisibilityPolicy();
+  if (policy.enabled) {
+    const all = await listSeriesWithVolumes({
+      authorNames: options?.authorNames,
+      genreNames: options?.genreNames,
+      tagNames: options?.tagNames,
+      seriesIds: options?.seriesIds,
+      includeGenres: options?.includeGenres,
+      includeTags: options?.includeTags,
+      scope: options?.scope,
+    });
+    const pagination = buildPagination(options);
+    return mapPaginatedResult(all.slice(pagination.offset, pagination.offset + pagination.pageSize), all.length, pagination);
+  }
   const pagedIds = await listPagedSeriesIdsCached({
     authorNames: options?.authorNames,
     genreNames: options?.genreNames,
@@ -1844,7 +1895,8 @@ export async function listSeriesVolumeAggregates(
 ): Promise<SeriesVolumeAggregate[]> {
   return query<{
     volume_id: string;
-    community_rating: number | null;
+      community_rating: number | null;
+      age_rating: string | null;
     writer: string | null;
     penciller: string | null;
     inker: string | null;
@@ -1860,6 +1912,7 @@ export async function listSeriesVolumeAggregates(
       SELECT
         mv.id AS volume_id,
         vm.community_rating,
+        vm.age_rating,
         vm.writer,
         vm.penciller,
         vm.inker,
@@ -1876,9 +1929,11 @@ export async function listSeriesVolumeAggregates(
       ORDER BY mv.sort_title ASC, mv.id ASC
     `,
     [seriesId]
-  ).then((rows) =>
-    rows.map((row) => ({
+  ).then(async (rows) => {
+    const policy = await getCurrentContentVisibilityPolicy();
+    return rows.filter((row) => canViewAgeRating(row.age_rating, "manga", policy)).map((row) => ({
       id: row.volume_id,
+      ageRating: row.age_rating,
       communityRating: row.community_rating,
       writer: row.writer,
       penciller: row.penciller,
@@ -1890,8 +1945,8 @@ export async function listSeriesVolumeAggregates(
       publisher: row.publisher,
       imprint: row.imprint,
       format: row.format,
-    }))
-  );
+    }));
+  });
 }
 
 async function findSeriesBySlugRaw(
@@ -1934,11 +1989,11 @@ async function findSeriesBySlugCached(options: FindSeriesOptions) {
 export async function findSeriesBySlug(
   options: FindSeriesOptions
 ): Promise<LibrarySeriesWithVolumes | null> {
-  if (options.userId) {
-    return findSeriesBySlugRaw(options);
-  }
-
-  return findSeriesBySlugCached(options);
+  const series = options.userId ? await findSeriesBySlugRaw(options) : await findSeriesBySlugCached(options);
+  if (!series) return null;
+  const policy = await getCurrentContentVisibilityPolicy();
+  const volumes = filterVisibleVolumes(series.volumes, policy);
+  return volumes.length ? { ...series, volumes } : null;
 }
 
 async function findVolumeBySlugRaw(
@@ -1981,16 +2036,15 @@ async function findVolumeBySlugCached(options: FindSeriesOptions) {
 export async function findVolumeBySlug(
   options: FindVolumeOptions
 ): Promise<LibraryVolume | null> {
-  if (options.userId) {
-    return findVolumeBySlugRaw(options);
-  }
-
-  return findVolumeBySlugCached({
+  const volume = options.userId ? await findVolumeBySlugRaw(options) : await findVolumeBySlugCached({
     slug: options.slug,
     includeGenres: options.includeGenres,
     includeTags: options.includeTags,
     scope: options.scope,
   });
+  if (!volume) return null;
+  const policy = await getCurrentContentVisibilityPolicy();
+  return canViewAgeRating(volume.metadataObj?.ageRating, "manga", policy) ? volume : null;
 }
 
 export async function findVolumePageCountById(

package/dist/src/lib/db/migrations/014_parental_controls.sql

@@ -0,0 +1,22 @@
+ALTER TABLE users
+  ADD COLUMN IF NOT EXISTS birth_month SMALLINT,
+  ADD COLUMN IF NOT EXISTS birth_day SMALLINT,
+  ADD COLUMN IF NOT EXISTS parental_control_enabled BOOLEAN NOT NULL DEFAULT FALSE,
+  ADD COLUMN IF NOT EXISTS parental_control_mode TEXT NOT NULL DEFAULT 'flexible';
+
+ALTER TABLE users
+  ADD CONSTRAINT users_birth_date_valid CHECK (
+    (birth_month IS NULL AND birth_day IS NULL)
+    OR (
+      birth_year IS NOT NULL
+      AND birth_month BETWEEN 1 AND 12
+      AND birth_day BETWEEN 1 AND 31
+      AND make_date(birth_year, birth_month, birth_day) IS NOT NULL
+    )
+  ),
+  ADD CONSTRAINT users_parental_control_mode_valid CHECK (
+    parental_control_mode IN ('flexible', 'strict')
+  );
+
+ALTER TABLE app_settings
+  ADD COLUMN IF NOT EXISTS parental_control_enabled BOOLEAN NOT NULL DEFAULT FALSE;

package/dist/src/lib/db/migrations/015_parental_control_global_mode.sql

@@ -0,0 +1,5 @@
+ALTER TABLE app_settings
+  ADD COLUMN IF NOT EXISTS parental_control_mode TEXT NOT NULL DEFAULT 'flexible',
+  ADD CONSTRAINT app_settings_parental_control_mode_valid CHECK (
+    parental_control_mode IN ('flexible', 'strict')
+  );

package/dist/src/lib/db/types.ts

@@ -10,6 +10,10 @@ export interface UserRow {
   name: string | null;
   lastname: string | null;
   birth_year: number | null;
+  birth_month: number | null;
+  birth_day: number | null;
+  parental_control_enabled: boolean;
+  parental_control_mode: "flexible" | "strict";
   profile_image: string | null;
 }
 
@@ -21,5 +25,9 @@ export interface PublicUser {
   name: string | null;
   lastname: string | null;
   birthYear: number | null;
+  birthMonth: number | null;
+  birthDay: number | null;
+  parentalControlEnabled: boolean;
+  parentalControlMode: "flexible" | "strict";
   profileImage: string | null;
 }

package/dist/src/lib/db/users.ts

@@ -11,6 +11,10 @@ function mapUser(row: UserRow): PublicUser {
     name: row.name,
     lastname: row.lastname,
     birthYear: row.birth_year,
+    birthMonth: row.birth_month,
+    birthDay: row.birth_day,
+    parentalControlEnabled: row.parental_control_enabled,
+    parentalControlMode: row.parental_control_mode,
     profileImage: row.profile_image,
   };
 }
@@ -31,7 +35,7 @@ export async function findUserByUsername(
 ): Promise<UserWithPassword | null> {
   const row = await queryOne<UserRow>(
     `
-      SELECT id, created_at, username, password, is_admin, role, name, lastname, birth_year
+      SELECT id, created_at, username, password, is_admin, role, name, lastname, birth_year, birth_month, birth_day, parental_control_enabled, parental_control_mode
       , profile_image
       FROM users
       WHERE username = $1 AND disabled_at IS NULL
@@ -46,7 +50,7 @@ export async function findUserByUsername(
 export async function findUserSessionById(id: string): Promise<PublicUser | null> {
   const row = await queryOne<UserRow>(
     `
-      SELECT id, created_at, username, password, is_admin, role, name, lastname, birth_year
+      SELECT id, created_at, username, password, is_admin, role, name, lastname, birth_year, birth_month, birth_day, parental_control_enabled, parental_control_mode
       , profile_image
       FROM users
       WHERE id = $1 AND disabled_at IS NULL
@@ -60,7 +64,7 @@ export async function findUserSessionById(id: string): Promise<PublicUser | null
 
 export async function listUsers(): Promise<PublicUser[]> {
   const rows = await query<UserRow>(`
-    SELECT id, created_at, username, password, is_admin, role, name, lastname, birth_year
+    SELECT id, created_at, username, password, is_admin, role, name, lastname, birth_year, birth_month, birth_day, parental_control_enabled, parental_control_mode
     , profile_image
     FROM users
     ORDER BY COALESCE(name, username) ASC, username ASC
@@ -106,6 +110,8 @@ export interface CreateUserInput {
   name?: string | null;
   lastname?: string | null;
   birthYear?: number | null;
+  birthMonth?: number | null;
+  birthDay?: number | null;
   isAdmin?: boolean;
   role?: Role;
 }
@@ -124,10 +130,12 @@ export async function createUserRecord(
         name,
         lastname,
         birth_year,
+        birth_month,
+        birth_day,
         profile_image
       )
-      VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)
-      RETURNING id, created_at, username, password, is_admin, role, name, lastname, birth_year, profile_image
+      VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11)
+      RETURNING id, created_at, username, password, is_admin, role, name, lastname, birth_year, birth_month, birth_day, parental_control_enabled, parental_control_mode, profile_image
     `,
     [
       crypto.randomUUID(),
@@ -138,6 +146,8 @@ export async function createUserRecord(
       input.name ?? null,
       input.lastname ?? null,
       input.birthYear ?? null,
+      input.birthMonth ?? null,
+      input.birthDay ?? null,
       null,
     ]
   );
@@ -157,6 +167,10 @@ export async function updateUserRecord(
     name?: string | null;
     lastname?: string | null;
     birthYear?: number | null;
+    birthMonth?: number | null;
+    birthDay?: number | null;
+    parentalControlEnabled?: boolean;
+    parentalControlMode?: "flexible" | "strict";
     isAdmin?: boolean;
     role?: Role;
     profileImage?: string | null;
@@ -190,6 +204,26 @@ export async function updateUserRecord(
     assignments.push(`birth_year = $${values.length}`);
   }
 
+  if (input.birthMonth !== undefined) {
+    values.push(input.birthMonth);
+    assignments.push(`birth_month = $${values.length}`);
+  }
+
+  if (input.birthDay !== undefined) {
+    values.push(input.birthDay);
+    assignments.push(`birth_day = $${values.length}`);
+  }
+
+  if (input.parentalControlEnabled !== undefined) {
+    values.push(input.parentalControlEnabled);
+    assignments.push(`parental_control_enabled = $${values.length}`);
+  }
+
+  if (input.parentalControlMode !== undefined) {
+    values.push(input.parentalControlMode);
+    assignments.push(`parental_control_mode = $${values.length}`);
+  }
+
   if (input.isAdmin !== undefined) {
     values.push(input.isAdmin);
     assignments.push(`is_admin = $${values.length}`);
@@ -216,7 +250,7 @@ export async function updateUserRecord(
       UPDATE users
       SET ${assignments.join(", ")}
       WHERE id = $${values.length}
-      RETURNING id, created_at, username, password, is_admin, role, name, lastname, birth_year, profile_image
+      RETURNING id, created_at, username, password, is_admin, role, name, lastname, birth_year, birth_month, birth_day, parental_control_enabled, parental_control_mode, profile_image
     `,
     values
   );

package/dist/src/lib/i18n/dictionaries/en/clubs.json

@@ -58,6 +58,7 @@
     "startVote": "Start vote",
     "chooseDifferentWorks": "Choose a different work for each candidate.",
     "voteDeadlineRequired": "Choose a future date before starting the vote.",
+    "votingMustClose": "Voting must close before choosing a work.",
     "archive": "Archive club",
     "milestones": "Milestones",
     "milestoneLabel": "For example, Volume 3",
@@ -70,6 +71,6 @@
     "joinGuest": "Join as a guest",
     "username": "Username",
     "password": "Password (8 characters minimum)",
-    "createGuest": "Create access and request"
+    "createGuest": "Request"
   }
 }

package/dist/src/lib/i18n/dictionaries/en/filters.json

@@ -6,7 +6,7 @@
     "authors": "Authors",
     "genres": "Genres",
     "tags": "Tags",
-    "apply": "Apply Filters",
-    "clean": "Clean Filters"
+    "apply": "Apply",
+    "clean": "Clear"
   }
 }

package/dist/src/lib/i18n/dictionaries/en/profile.json

@@ -25,6 +25,18 @@
     "usrAdmin": "Owner",
     "usrNormal": "Member",
     "age": "Years",
+    "parentalControl": "Parental control",
+    "parentalControlHelp": "Choose the content you want to hide in your library.",
+    "parentalControlEnabled": "Enable parental control",
+    "parentalControlFlexible": "Flexible",
+    "parentalControlFlexibleHelp": "Only hides 18+ works.",
+    "parentalControlStrict": "Strict",
+    "parentalControlStrictHelp": "Hides works from 16+ and unrated works.",
+    "parentalControlMinor": "Your content limit is automatically applied according to your age.",
+    "parentalControlMissingBirthDate": "An administrator must complete your date of birth to adjust this control.",
+    "parentalControlGlobalDisabled": "Global parental control is disabled by the administrator.",
+    "parentalControlGlobalStrict": "The administrator enabled strict mode for minor accounts.",
+    "parentalControlUpdateError": "Could not update parental control.",
     "challenges": {
       "title": "Reading Challenges",
       "challenge": "Challenge",

package/dist/src/lib/i18n/dictionaries/en/settings.json

@@ -21,7 +21,9 @@
     "edit": "Edit",
     "nameOpt": "Name (optional)",
     "lastnameOpt": "Lastname (optional)",
-    "birthYearOpt": "Birth Year (optional)",
+    "birthYearOpt": "Birth year",
+    "birthMonth": "Birth month",
+    "birthDay": "Birth day",
     "isAdmin": "Super Admin",
     "role": "Role",
     "roleAdmin": "Admin",
@@ -71,6 +73,16 @@
     "regeneratingCovers": "Regenerating...",
     "regenerateCovers": "Regenerate Covers",
     "reprocessingMeta": "Processing...",
-    "reprocessMetadata": "Process Metadata"
+    "reprocessMetadata": "Process Metadata",
+    "parentalControl": "Parental control",
+    "parentalControlGlobalHelp": "Enable age protection across the entire library. Adults keep control over their own filters.",
+    "parentalControlGlobalOn": "Global parental control is enabled.",
+    "parentalControlGlobalOff": "Global parental control is disabled.",
+    "parentalControlGlobalLevel": "Global level",
+    "parentalControlFlexible": "Flexible",
+    "parentalControlStrict": "Strict",
+    "parentalControlGlobalFlexibleHelp": "Protects minors according to their age and lets adults choose their own filter.",
+    "parentalControlGlobalStrictHelp": "Applies a 15+ limit and hides unrated works for minor accounts.",
+    "parentalControlUpdateError": "Could not update parental control."
   }
 }

package/dist/src/lib/i18n/dictionaries/es/clubs.json

@@ -58,6 +58,7 @@
     "startVote": "Iniciar votación",
     "chooseDifferentWorks": "Elegí obras distintas para cada candidata.",
     "voteDeadlineRequired": "Definí una fecha futura para iniciar la votación.",
+    "votingMustClose": "La votación debe cerrar antes de elegir una obra.",
     "archive": "Archivar club",
     "milestones": "Hitos",
     "milestoneLabel": "Ej. Volumen 3",
@@ -70,6 +71,6 @@
     "joinGuest": "Unirme como invitado",
     "username": "Nombre de usuario",
     "password": "Contraseña (8 caracteres mínimo)",
-    "createGuest": "Crear acceso y solicitar"
+    "createGuest": "Solicitar"
   }
 }

package/dist/src/lib/i18n/dictionaries/es/filters.json

@@ -6,7 +6,7 @@
     "authors": "Autores",
     "genres": "Géneros",
     "tags": "Etiquetas",
-    "apply": "Aplicar filtros",
-    "clean": "Limpiar filtros"
+    "apply": "Aplicar",
+    "clean": "Limpiar"
   }
 }

package/dist/src/lib/i18n/dictionaries/es/profile.json

@@ -25,6 +25,18 @@
     "usrAdmin": "Propietario",
     "usrNormal": "Miembro",
     "age": "Años",
+    "parentalControl": "Control parental",
+    "parentalControlHelp": "Elegí qué contenido querés ocultar en tu biblioteca.",
+    "parentalControlEnabled": "Activar control parental",
+    "parentalControlFlexible": "Flexible",
+    "parentalControlFlexibleHelp": "Oculta solo obras 18+.",
+    "parentalControlStrict": "Estricto",
+    "parentalControlStrictHelp": "Oculta obras desde 16+ y las que no tienen clasificación.",
+    "parentalControlMinor": "Tu límite de contenido se aplica automáticamente según tu edad.",
+    "parentalControlMissingBirthDate": "Tu fecha de nacimiento debe ser completada por un administrador para ajustar este control.",
+    "parentalControlGlobalDisabled": "El control parental global está desactivado por el administrador.",
+    "parentalControlGlobalStrict": "El administrador activó el nivel estricto para cuentas de menores.",
+    "parentalControlUpdateError": "No se pudo actualizar el control parental.",
     "challenges": {
       "title": "Retos de lectura",
       "challenge": "Reto",

package/dist/src/lib/i18n/dictionaries/es/settings.json

@@ -21,7 +21,9 @@
     "edit": "Editar",
     "nameOpt": "Nombre (opcional)",
     "lastnameOpt": "Apellido (opcional)",
-    "birthYearOpt": "Año de nacimiento (opcional)",
+    "birthYearOpt": "Año de nacimiento",
+    "birthMonth": "Mes de nacimiento",
+    "birthDay": "Día de nacimiento",
     "isAdmin": "Super Admin",
     "role": "Rol",
     "roleAdmin": "Admin",
@@ -71,6 +73,16 @@
     "regeneratingCovers": "Regenerando...",
     "regenerateCovers": "Regenerar portadas",
     "reprocessingMeta": "Procesando...",
-    "reprocessMetadata": "Procesar metadatos"
+    "reprocessMetadata": "Procesar metadatos",
+    "parentalControl": "Control parental",
+    "parentalControlGlobalHelp": "Activa la protección por edad para toda la biblioteca. Los adultos conservan control sobre sus propios filtros.",
+    "parentalControlGlobalOn": "El control parental global está activado.",
+    "parentalControlGlobalOff": "El control parental global está desactivado.",
+    "parentalControlGlobalLevel": "Nivel global",
+    "parentalControlFlexible": "Flexible",
+    "parentalControlStrict": "Estricto",
+    "parentalControlGlobalFlexibleHelp": "Protege a menores según su edad y permite a los adultos elegir su propio filtro.",
+    "parentalControlGlobalStrictHelp": "Aplica un límite de 15+ y oculta obras sin clasificación para cuentas de menores.",
+    "parentalControlUpdateError": "No se pudo actualizar el control parental."
   }
 }

package/dist/src/lib/nav/profileNav.ts

@@ -2,6 +2,7 @@ import type { LucideIcon } from "lucide-react";
 import {
   BellIcon,
   LayoutPanelTopIcon,
+  ShieldCheckIcon,
   UserRoundPenIcon,
 } from "lucide-react";
 import type { DictionarySection } from "@/lib/types";
@@ -45,5 +46,11 @@ export function getProfileNavLinks({
       icon: BellIcon,
       isActive: pathname === `/${lang}/profile/notifications`,
     },
+    {
+      label: profile.parentalControl as string,
+      href: `/${lang}/profile/parental-control`,
+      icon: ShieldCheckIcon,
+      isActive: pathname === `/${lang}/profile/parental-control`,
+    },
   ];
 }

package/dist/src/lib/nav/settingsNav.ts

@@ -1,5 +1,5 @@
 import type { LucideIcon } from "lucide-react";
-import { FolderCogIcon, LayoutPanelTopIcon } from "lucide-react";
+import { FolderCogIcon, LayoutPanelTopIcon, ShieldCheckIcon } from "lucide-react";
 import type { Dictionary } from "@/lib/types";
 
 export interface SettingsNavLink {
@@ -35,5 +35,11 @@ export function getSettingsNavLinks({
       icon: FolderCogIcon,
       isActive: pathname.startsWith(`/${lang}/settings/library`),
     },
+    {
+      label: intl.settings.parentalControl as string,
+      href: `/${lang}/settings/parental-control`,
+      icon: ShieldCheckIcon,
+      isActive: pathname.startsWith(`/${lang}/settings/parental-control`),
+    },
   ];
 }

package/dist/src/lib/parentalControl.ts

@@ -0,0 +1,64 @@
+import type { Session } from "./types/auth.ts";
+import { getBookAgeMinimum } from "./books/metadata.ts";
+import { ageRatingMap } from "./mangaMetadata.ts";
+
+export type ParentalControlMode = "flexible" | "strict";
+
+export interface ContentVisibilityPolicy {
+  enabled: boolean;
+  maxAge: number | null;
+  allowUnrated: boolean;
+}
+
+function getExactAge(user: Session, now = new Date()): number | null {
+  if (user.birthYear === null) return null;
+
+  let age = now.getFullYear() - user.birthYear;
+  if (user.birthMonth !== null && user.birthDay !== null) {
+    const month = now.getMonth() + 1;
+    const day = now.getDate();
+    if (month < user.birthMonth || (month === user.birthMonth && day < user.birthDay)) {
+      age -= 1;
+    }
+  }
+
+  return age;
+}
+
+export function getContentVisibilityPolicy(
+  user: Session | null,
+  globallyEnabled: boolean,
+  globalMode: ParentalControlMode = "flexible",
+  now = new Date()
+): ContentVisibilityPolicy {
+  if (!globallyEnabled || !user) {
+    return { enabled: false, maxAge: null, allowUnrated: true };
+  }
+
+  const age = getExactAge(user, now);
+  if (age === null) return { enabled: true, maxAge: 15, allowUnrated: false };
+  if (age < 18) return {
+    enabled: true,
+    maxAge: globalMode === "strict" ? Math.min(Math.max(0, age), 15) : Math.max(0, age),
+    allowUnrated: globalMode === "flexible",
+  };
+  if (!user.parentalControlEnabled) return { enabled: false, maxAge: null, allowUnrated: true };
+  if (user.parentalControlMode === "strict") return { enabled: true, maxAge: 15, allowUnrated: false };
+  return { enabled: true, maxAge: 17, allowUnrated: true };
+}
+
+export function canViewAgeRating(
+  ageRating: string | null | undefined,
+  library: "book" | "manga",
+  policy: ContentVisibilityPolicy
+): boolean {
+  if (!policy.enabled) return true;
+  const minimum = library === "book" ? getBookAgeMinimum(ageRating) : ageRatingMap(ageRating);
+  if (minimum === null) return policy.allowUnrated;
+  return minimum <= (policy.maxAge ?? 18);
+}
+
+export function isAdult(user: Session, now = new Date()): boolean {
+  const age = getExactAge(user, now);
+  return age !== null && age >= 18;
+}