Skip to content

Every analytics tool wants a subscription. And your data. I built Twiligent instead. YouTube stats. Instagram stats. One dashboard. Runs locally on your machine.

3.0 KB
Raw Blame
import type { Platform } from '../../../shared/types/domain.ts';

export interface PlatformMeta {
  label: string;
  audienceLabel: string;
  series: string;
}

// the account fields these helpers read; raw api accounts and normalized app accounts both fit
export interface AccountFields {
  id?: string;
  platform?: string;
  title?: string | null;
  username?: string;
  channelId?: string;
  customUrl?: string;
  thumbnail?: string;
  profilePictureUrl?: string;
  thumbnails?: { default?: string };
  followersCount?: number;
  subscriberCount?: number;
}

export const PLATFORMS: Platform[] = ['youtube', 'instagram'];

export const PLATFORM_META: Record<Platform, PlatformMeta> = {
  youtube:   { label: 'YouTube',   audienceLabel: 'subscribers', series: 'var(--chart-1)' },
  instagram: { label: 'Instagram', audienceLabel: 'followers',   series: 'var(--chart-3)' },
};

// Accounts saved before multi-platform support have no platform field and are YouTube channels
export function platformOf(account: AccountFields | null | undefined): Platform {
  const platform = account?.platform;
  return platform === 'instagram' ? platform : 'youtube';
}

export function accountPath(account: AccountFields): string {
  const platform = platformOf(account);
  if (platform === 'instagram') return `/instagram/${account.id}`;
  return `/channel/${account.id}`;
}

export function accountName(account: AccountFields | null | undefined): string {
  if (!account) return '';
  return account.title || account.username || account.channelId || '';
}

export function accountHandle(account: AccountFields | null | undefined): string {
  if (!account) return '';
  const platform = platformOf(account);
  if (platform === 'instagram') return account.username ? `@${account.username}` : '';
  return account.customUrl || account.channelId || '';
}

export function accountImage(account: AccountFields | null | undefined): string {
  if (!account) return '';
  return account.thumbnail || account.profilePictureUrl || account.thumbnails?.default || '';
}

export function accountInitials(account: AccountFields | null | undefined): string {
  const source = account?.title || account?.username || '?';
  return source.slice(0, 2).toUpperCase();
}

export function audienceOf(account: AccountFields): number {
  const platform = platformOf(account);
  if (platform === 'instagram') return account.followersCount || 0;
  return account.subscriberCount || 0;
}

export function groupByPlatform<T extends AccountFields>(accounts: T[] | null | undefined): Record<Platform, T[]> {
  const groups: Record<Platform, T[]> = { youtube: [], instagram: [] };
  for (const account of accounts || []) groups[platformOf(account)].push(account);
  return groups;
}

// "2 YouTube, 1 Instagram" style summary, empty platforms omitted
export function platformSummary(accounts: AccountFields[] | null | undefined): string {
  const groups = groupByPlatform(accounts);
  return PLATFORMS
    .filter(p => groups[p].length > 0)
    .map(p => `${groups[p].length} ${PLATFORM_META[p].label}`)
    .join(', ');
}