Types

import type {
  UploadOptions,
  UploadItem,
  StorageState,
} from "firebase-storage-kit";

interface UploadOptions {
  path: string;
  validate?: UploadValidationOptions;
  retry?: RetryOptions | false;
  contentType?: string;
  customMetadata?: Record<string, string>;
}

interface UploadValidationOptions {
  maxSizeBytes?: number;
  allowedMimeTypes?: string[];
  allowedExtensions?: string[];
  maxImageWidth?: number;
  maxImageHeight?: number;
}

interface RetryOptions {
  maxRetries?: number;
  initialDelayMs?: number;
  maxDelayMs?: number;
  jitter?: boolean;
  isRetryable?: (error: Error) => boolean;
}

interface UploadItem {
  id: string;
  file: File;
  path: string;
  progress: number;
  bytesTransferred: number;
  totalBytes: number;
  status: UploadStatus;
  downloadURL?: string;
  error?: Error;
  attempt?: number;
  /** @deprecated alias of `attempt` */
  retryAttempt?: number;
  batchId?: string;
}

type UploadStatus =
  | "queued"
  | "uploading"
  | "retrying"
  | "paused"
  | "success"
  | "error"
  | "canceled";

interface StorageState {
  uploads: UploadItem[];
  batches: UploadBatch[];
}

interface UploadBatch {
  id: string;
  uploads: UploadItem[];
  totalProgress: number;
  completedCount: number;
  failedCount: number;
}

interface FileMetadata {
  name: string;
  bucket: string;
  size: number;
  contentType?: string;
  timeCreated?: string;
  updated?: string;
  customMetadata?: Record<string, string>;
}

interface StorageListItem {
  path: string;
  name: string;
}

interface StorageListResult {
  prefixes: string[];
  items: StorageListItem[];
  nextPageToken?: string;
}

interface ListOptions {
  maxResults?: number;
  pageToken?: string;
}