import type { Amount } from './Amount';
import { InterfaceImplementationMissingError } from './errors';
import type { GenericAbortSignal } from './GenericAbortSignal';
import type { GenericFile } from './GenericFile';

/**
 * Defines the interface for an uploader.
 * It allows us to upload files and get their URIs.
 *
 * @category Context and Interfaces
 */
export interface UploaderInterface {
  /** Uploads multiple files and returns their URIs. */
  upload: (
    files: GenericFile[],
    options?: UploaderUploadOptions
  ) => Promise<string[]>;

  /** Uploads a JSON object and returns its URI. */
  uploadJson: <T>(json: T, options?: UploaderUploadOptions) => Promise<string>;

  /** Gets the price to upload a list of files. */
  getUploadPrice: (
    files: GenericFile[],
    options?: UploaderGetUploadPriceOptions
  ) => Promise<Amount>;
}

/**
 * The options that can be passed when fetching the upload price.
 * @category Storage
 */
export type UploaderGetUploadPriceOptions = {
  signal?: GenericAbortSignal;
};

/**
 * The options that can be passed when uploading files.
 * @category Storage
 */
export type UploaderUploadOptions = {
  onProgress?: (percent: number, ...args: any) => void;
  signal?: GenericAbortSignal;
  manifest?: boolean;
};

/**
 * An implementation of the {@link UploaderInterface} that throws an error when called.
 * @category Storage
 */
export function createNullUploader(): UploaderInterface {
  const errorHandler = () => {
    throw new InterfaceImplementationMissingError(
      'UploaderInterface',
      'uploader'
    );
  };
  return {
    upload: errorHandler,
    uploadJson: errorHandler,
    getUploadPrice: errorHandler,
  };
}