/* INPUT */

/**
 * Consultation.
 *
 * `consult` can be "undetermined" if only a scheme was given
 * instead of a full URI.
 */
export type Consult =
  | { supported: false; reason: string }
  | { supported: true; consult: "undetermined" | boolean };

export type ConsultGrouping =
  | { available: false; reason: string }
  | { available: true; tracks: Track[] };

export type GroupConsult = Record<string, ConsultGrouping>;

/* OUTPUT */

export interface Output<S = TrackStats, T = TrackTags> {
  tracks: Track<S, T>[];
}

export interface ManagedOutput<S = TrackStats, T = TrackTags> {
  tracks: {
    cacheId: string;
    state: "loading" | "loaded";
    collection: Track<S, T>[];
  };
}

/* TRACKS */

export type ResolvedUri = undefined | { url: string; expiresAt: number }; // TODO: Streams?

export interface Track<Stats = TrackStats, Tags = TrackTags> {
  id: string;

  kind?: "music" | "audiobook" | "podcast" | "miscellaneous";
  stats?: Stats;
  tags?: Tags;

  // NOTE: This is a "semi-permanent" URI.
  //
  // Tracks are cached so you can't, for example,
  // use an URL that expires in several hours.
  uri: string;
}

export interface TrackStats {
  bitrate?: number;
  duration?: number;
}

export interface TrackTags {
  album?: string;
  artist?: string;
  disc: { no: number; of?: number };
  genre?: string;
  title: string;
  track: { no: number; of?: number };
  year?: number;
}
