KVideo/lib/utils/sync-records.ts

import type { FavoriteItem, VideoHistoryItem } from '@/lib/types';

function hasIdentity(value: unknown): boolean {
  if (!value || typeof value !== 'object') return false;
  const record = value as { videoId?: unknown; source?: unknown; title?: unknown };
  const videoId = record.videoId;
  const hasVideoId = typeof videoId === 'string'
    ? videoId.trim().length > 0
    : typeof videoId === 'number' && Number.isFinite(videoId);

  return hasVideoId &&
    typeof record.source === 'string' && record.source.trim().length > 0 &&
    typeof record.title === 'string' && record.title.trim().length > 0;
}

/**
 * Records restored from server-side sync are not guaranteed to be well formed —
 * they may come from an older schema or a partial write. Rendering one without
 * `videoId` or `episodeIndex` throws while building the player URL, which takes
 * down the whole page, so anything lacking the required URL fields is dropped.
 */
export function isRenderableHistoryItem(value: unknown): value is VideoHistoryItem {
  if (!hasIdentity(value)) return false;
  const episodeIndex = (value as { episodeIndex?: unknown }).episodeIndex;
  return typeof episodeIndex === 'number' && Number.isInteger(episodeIndex) && episodeIndex >= 0;
}

export function isRenderableFavoriteItem(value: unknown): value is FavoriteItem {
  return hasIdentity(value);
}

export function keepRenderableHistory(items: unknown): VideoHistoryItem[] {
  return Array.isArray(items) ? items.filter(isRenderableHistoryItem) : [];
}

export function keepRenderableFavorites(items: unknown): FavoriteItem[] {
  return Array.isArray(items) ? items.filter(isRenderableFavoriteItem) : [];
}