import { Client } from '../client.js';

export interface FavoriteCreateParams {
  /**
   * Steam sharedfile URL (artwork, screenshot, workshop item, guide).
   *
   * Reviews are NOT supported — Steam doesn't expose a favorite endpoint for reviews.
   * Passing a review URL will return a 400 error.
   */
  steamId: string;
  /** Number of favorites to send (each uses 1 distinct bot) */
  amount: number;
}

export interface FavoriteSession {
  session_id: number;
  sharedfile_id: string;
  /** Always 'sharedfile' for favorites — reviews can't be favorited */
  target_type: 'sharedfile';
  type: 'favorite';
  requested: number;
  success: number;
  failed: number;
  status: 'QUEUED' | 'running' | 'done' | 'canceled';
  daily_used?: number;
  credits_used?: number;
  createdAt?: string;
  updatedAt?: string;
  [key: string]: unknown;
}

export interface FavoriteListParams {
  /** Max results (1-100, default: 20) */
  limit?: number;
}

/**
 * Steam favorite operations
 */
export class FavoriteResource {
  constructor(client: Client);

  /**
   * Queue a favorite session
   */
  create(params: FavoriteCreateParams): Promise<FavoriteSession>;

  /**
   * Get favorite session status
   */
  get(sessionId: number): Promise<FavoriteSession>;

  /**
   * List favorite sessions
   */
  list(params?: FavoriteListParams): Promise<FavoriteSession[]>;

  /**
   * Cancel a favorite session
   */
  cancel(sessionId: number): Promise<{ success: boolean; message?: string }>;
}