client.files

import { VlmRun } from "vlmrun";

const client = new VlmRun({
  apiKey: "your-api-key",
});

// Upload a file using local file path
const file = await client.files.upload({
  filePath: "path/to/document.pdf",
});

// The response includes the file ID and metadata
console.log(file.id); // "file_abc123"
console.log(file.filename); // "document.pdf"
console.log(file.bytes); // 1234567
console.log(file.purpose); // "document"
console.log(file.created_at); // "2024-01-01T00:00:00Z"

// Get a file by ID
const file = await client.files.get("file_abc123");

type FilePurpose = string;

interface FileResponse {
  id: string;
  filename: string;
  bytes: number;
  purpose: FilePurpose;
  created_at: string;
  object: "file";
}

try {
  const file = await client.files.upload({
    filePath: "nonexistent.pdf",
  });
} catch (error) {
  if (error instanceof ApiError) {
    console.error("API Error:", error.message);
    // Handle API-specific errors (rate limits, permissions, etc.)
  } else {
    console.error("File system error:", error);
    // Handle local file system errors
  }
}