Michael Freno
15f8a098b5
Episode search results gain d (download), D (delete), x (unsubscribe) and enter (play for subscribed shows); downloads of unsubscribed shows are recorded with the show's metadata under a deterministic synthetic feed id and listed under an "Unsubscribed Show Downloads" section in My Shows and the settings Download Manager. Classified at render time by feed id or feed URL, so subscribing re-classifies the downloads and unsubscribing purges them.
132 lines
3.4 KiB
TypeScript
132 lines
3.4 KiB
TypeScript
/**
|
|
* Episode type definitions for PodTUI
|
|
*/
|
|
|
|
/** Episode playback status */
|
|
export enum EpisodeStatus {
|
|
NOT_STARTED = "not_started",
|
|
PLAYING = "playing",
|
|
PAUSED = "paused",
|
|
COMPLETED = "completed",
|
|
}
|
|
|
|
/** Core episode information */
|
|
export interface Episode {
|
|
/** Unique identifier */
|
|
id: string
|
|
/** Parent podcast ID */
|
|
podcastId: string
|
|
/** Episode title */
|
|
title: string
|
|
/** Episode description/show notes */
|
|
description: string
|
|
/** Audio file URL */
|
|
audioUrl: string
|
|
/** Duration in seconds */
|
|
duration: number
|
|
/** Publication date */
|
|
pubDate: Date
|
|
/** Episode number (if available) */
|
|
episodeNumber?: number
|
|
/** Season number (if available) */
|
|
seasonNumber?: number
|
|
/** Episode type (full, trailer, bonus) */
|
|
episodeType?: EpisodeType
|
|
/** Whether episode is explicit */
|
|
explicit?: boolean
|
|
/** Episode image URL (if different from podcast) */
|
|
imageUrl?: string
|
|
/** File size in bytes */
|
|
fileSize?: number
|
|
/** MIME type */
|
|
mimeType?: string
|
|
}
|
|
|
|
/** Episode type enumeration */
|
|
export enum EpisodeType {
|
|
FULL = "full",
|
|
TRAILER = "trailer",
|
|
BONUS = "bonus",
|
|
}
|
|
|
|
/** Episode playback progress */
|
|
export interface Progress {
|
|
/** Episode ID */
|
|
episodeId: string
|
|
/** Current position in seconds */
|
|
position: number
|
|
/** Total duration in seconds */
|
|
duration: number
|
|
/** Last played timestamp */
|
|
timestamp: Date
|
|
/** Playback speed (1.0 = normal) */
|
|
playbackSpeed?: number
|
|
}
|
|
|
|
/** Episode with playback state */
|
|
export interface EpisodeWithProgress extends Episode {
|
|
/** Current playback status */
|
|
status: EpisodeStatus
|
|
/** Playback progress */
|
|
progress?: Progress
|
|
}
|
|
|
|
/** Episode list item for display */
|
|
export interface EpisodeListItem {
|
|
/** Episode data */
|
|
episode: Episode
|
|
/** Podcast title (for display in feeds) */
|
|
podcastTitle: string
|
|
/** Podcast cover URL */
|
|
podcastCoverUrl?: string
|
|
/** Current status */
|
|
status: EpisodeStatus
|
|
/** Progress percentage (0-100) */
|
|
progressPercent: number
|
|
}
|
|
|
|
/** Download status for an episode */
|
|
export enum DownloadStatus {
|
|
NONE = "none",
|
|
QUEUED = "queued",
|
|
DOWNLOADING = "downloading",
|
|
COMPLETED = "completed",
|
|
FAILED = "failed",
|
|
}
|
|
|
|
/** Metadata for a downloaded episode */
|
|
export interface DownloadedEpisode {
|
|
/** Episode ID */
|
|
episodeId: string
|
|
/** Feed ID the episode belongs to. For downloads of shows that aren't
|
|
* subscribed (search downloads) this is a deterministic synthetic id
|
|
* ("unsub-<slug>") that also names the file subdirectory. */
|
|
feedId: string
|
|
/** Current download status */
|
|
status: DownloadStatus
|
|
/** Download progress 0-100 */
|
|
progress: number
|
|
/** Absolute path to the downloaded file */
|
|
filePath: string | null
|
|
/** When the download completed */
|
|
downloadedAt: Date | null
|
|
/** Download speed in bytes/sec (while downloading) */
|
|
speed: number
|
|
/** File size in bytes */
|
|
fileSize: number
|
|
/** Error message if failed */
|
|
error: string | null
|
|
/** Episode title, persisted so unsubscribed-show downloads render without
|
|
* a loaded feed. */
|
|
episodeTitle?: string
|
|
/** Audio URL, persisted so queued downloads survive a restart. */
|
|
audioUrl?: string
|
|
/** Publication date (ISO), for display of unsubscribed-show downloads. */
|
|
pubDate?: string
|
|
/** Show title, kept for downloads whose show isn't subscribed. */
|
|
podcastTitle?: string
|
|
/** The show's RSS feed URL, used to re-classify a download as subscribed
|
|
* once the user subscribes to its show. */
|
|
podcastFeedUrl?: string
|
|
}
|