index.ts

import { Client } from '../client';
import {
  fileListEndpoint,
  fileDeleteEndpoint,
  fileRetrieveEndpoint,
} from '../../client/endpoints';
import { uploadFile } from '../../files/upload';
import type {
  FileUploadResponse,
  FileListResponse,
  FileDeleteResponse,
  FileRetrieveResponse,
} from '../../types/api';
import { SDKError } from '../../errors/base';
import { ExitCode } from '../../errors/codes';

export class FileSDK extends Client {
  /**
   * Upload a file to MiniMax storage.
   *
   * @param filePath - Absolute or relative path to the file on disk.
   * @param purpose  - File purpose, defaults to `"retrieval"`.
   */
  async upload(filePath: string, purpose = 'retrieval'): Promise<FileUploadResponse> {
    return uploadFile({
      filePath,
      purpose,
      baseUrl: this.config.baseUrl,
      requestJson: (opts) => this.requestJson<FileUploadResponse>(opts),
      createFileNotFoundError: (fullPath) =>
        new SDKError(`File not found: ${fullPath}`, ExitCode.USAGE),
    });
  }

  /** List all files in MiniMax storage. */
  async list(): Promise<FileListResponse> {
    const url = fileListEndpoint(this.config.baseUrl);
    return this.requestJson<FileListResponse>({ url, method: 'GET' });
  }

  /**
   * Delete a file from MiniMax storage by its file ID.
   *
   * @param fileId - The ID of the file to delete (string or number).
   */
  async delete(fileId: string | number): Promise<FileDeleteResponse> {
    const url = fileDeleteEndpoint(this.config.baseUrl);
    return this.requestJson<FileDeleteResponse>({
      url,
      method: 'POST',
      body: { file_id: Number(fileId) },
    });
  }

  /**
   * Retrieve metadata (and optional download URL) for a file.
   *
   * @param fileId - The ID of the file to retrieve.
   */
  async retrieve(fileId: string): Promise<FileRetrieveResponse> {
    const url = fileRetrieveEndpoint(this.config.baseUrl, fileId);
    return this.requestJson<FileRetrieveResponse>({ url, method: 'GET' });
  }
}