export type SpecResource = {
  id: string
  version: string
  title: string
  description: string
  url: string
  size_mb: number
}

export type SpecTier = {
  name: string
  slug: string
  description: string
  recommended?: boolean
  includesTier?: string
  resources: SpecResource[]
}

export type SpecCategory = {
  name: string
  slug: string
  icon: string
  description: string
  language: string
  tiers: SpecTier[]
}

export type SpecCollection = {
  name: string
  slug: string
  description: string
  icon: string
  language: string
  resources: SpecResource[]
}

export type ZimCategoriesSpec = {
  spec_version: string
  categories: SpecCategory[]
}

export type MapsSpec = {
  spec_version: string
  collections: SpecCollection[]
}

export type WikipediaOption = {
  id: string
  name: string
  description: string
  size_mb: number
  url: string | null
  version: string | null
}

export type WikipediaSpec = {
  spec_version: string
  options: WikipediaOption[]
}

// ---- Creator Packs spec ----
//
// A creator pack is a branded ZIM of a creator's curated YouTube videos, served
// offline through Kiwix. The public catalog carries display metadata ONLY — there
// is NO download url here. The bytes live in a private R2 bucket behind an
// entitlement Worker; CreatorPackService resolves the (stable) Worker URL and
// sends the auth header at install time. See project_content_creator_packs.
export type CreatorPack = {
  id: string
  name: string
  creator: string
  description: string
  /** YYYY-MM; combines with id as `<id>_<version>.zim` (parseZimFilename). */
  version: string
  /** InstalledResource.resource_id used for install/status reconciliation. */
  resource_id: string
  video_count: number
  size_mb: number
  license_id: string
  /** Optional card art (Phase 2). The Kiwix grid icon is baked into the ZIM. */
  poster_url?: string
  logo_url?: string
}

export type CreatorPacksSpec = {
  spec_version: string
  packs: CreatorPack[]
}

export type CreatorPackStatus = 'installed' | 'downloading' | 'available'

export type CreatorPackWithStatus = CreatorPack & {
  status: CreatorPackStatus
  installed_version?: string
  /** Set when an installed pack has a newer catalog version available. */
  available_update_version?: string
}

export type ManifestType = 'zim_categories' | 'maps' | 'wikipedia' | 'creator_packs'

export type ResourceStatus = 'installed' | 'not_installed' | 'update_available'

export type CategoryWithStatus = SpecCategory & {
  installedTierSlug?: string
  // Highest tier whose every resource is either installed OR has an in-flight
  // download. Set only when it differs from installedTierSlug — i.e. the user
  // picked something larger and downloads are still running. Lets the UI show
  // the user's actual intent during the (often long) download window.
  downloadingTierSlug?: string
}

export type CollectionWithStatus = SpecCollection & {
  all_installed: boolean
  installed_count: number
  total_count: number
}

export type ResourceUpdateCheckRequest = {
  resources: Array<{
    resource_id: string
    resource_type: 'zim' | 'map'
    installed_version: string
  }>
}

export type ResourceUpdateInfo = {
  resource_id: string
  resource_type: 'zim' | 'map'
  installed_version: string
  latest_version: string
  download_url: string
  size_bytes?: number
}

export type ContentUpdateCheckResult = {
  updates: ResourceUpdateInfo[]
  checked_at: string
  error?: string
}