interface PrinterDetails {
  name: string;
  isDefault: boolean;
  state: "idle" | "processing" | "stopped"; // IPP printer-state
  stateReasons: string[]; // IPP printer-state-reasons keywords
  jobs: JobDetails[];
  raw: Record<string, any>; // platform-specific data (CUPS options / Windows PRINTER_INFO_2)
}

interface JobDetails {
  id: number; // job identifier
  name: string; // document/job title
  printerName: string; // target printer
  user: string; // submitting user
  state: // IPP job-state
    | "pending"
    | "pending-held"
    | "processing"
    | "processing-stopped"
    | "canceled"
    | "aborted"
    | "completed";
  size: number; // size in bytes
  createdAt: number; // epoch seconds
  processingAt: number; // epoch seconds (0 if not yet processing)
  completedAt: number; // epoch seconds (0 if not yet completed)
  raw: Record<string, any>; // platform-specific data
}

// Get all printers
function getPrinters(): PrinterDetails[];

// Get specific printer, or null if it does not exist
function getPrinter(printer: string): PrinterDetails | null;

// Send data or a file to a printer, returns the job ID
function print(options: {
  printer: string; // printer name
  data?: string | Uint8Array; // data to print
  format?: string; // data format, e.g. "RAW", "TEXT" (default "RAW")
  filename?: string; // path to file (POSIX only, alternative to data)
  docname?: string; // document name shown in the queue
  options?: Record<string, string>; // platform-specific print options
}): number;

// Get job details, or null if the job no longer exists
function getJob(printer: string, jobId: number): JobDetails | null;

// Cancel a print job; no-op if the job no longer exists
function cancelJob(printer: string, jobId: number): void;

// Returns the built-in format aliases accepted by the format option
function getSupportedPrintFormats(): string[];