declare module '@/lib/utils/api-common' {
  export type UserDefineFetchStatus = 'success' | 'empty' | 'unauthenticated' | 'error'
  export type StorageBackend = 'auto' | 'yiban' | 'session'

  export interface StorageOptions {
    backend?: StorageBackend
  }

  export interface WriteOptions extends StorageOptions {
    critical?: boolean
    bypassQueue?: boolean
    deadlineMs?: number
    silent?: boolean
  }

  export interface WriteResult {
    success: boolean
    skipped?: boolean
    superseded?: boolean
    code?: number
    message?: string
    attempts?: number
  }

  export interface UserDefineFetchResult {
    status: UserDefineFetchStatus
    content: string
    code?: number
    message?: string
  }

  export function setUserDefine(
    lessonId: string | number,
    key: string | number,
    value: string,
    options?: WriteOptions
  ): Promise<WriteResult>

  export function getUserDefineResult(
    lessonId: string | number,
    key: string | number,
    options?: StorageOptions
  ): Promise<UserDefineFetchResult>

  export function parseUserDefineContent<T>(content: string, options?: StorageOptions): T

  export function setCourseTimeProgress(
    order: number,
    options?: Pick<WriteOptions, 'bypassQueue' | 'deadlineMs'>
  ): Promise<WriteResult>
}