import { APIResource } from "../../core/resource.js";
import * as UploadsAPI from "./uploads.js";
import { APIPromise } from "../../core/api-promise.js";
import { Cursor, PagePromise, type CursorParams } from "../../core/pagination.js";
import { type Uploadable } from "../../core/uploads.js";
import { RequestOptions } from "../../internal/request-options.js";
import { type FileCreateParamsWithMultipart, type FileHelpers } from "../../lib/files.js";
import { MultipartUploadPart, MultipartUploadPartURL, UploadAbortResponse, UploadCompleteParams, UploadCreateParams, UploadCreateResponse, UploadListResponse, UploadRetrieveResponse, Uploads } from "./uploads.js";
export type { FileCreateParamsWithMultipart, FileHelpers };
export declare class FilesBase extends APIResource {
    uploads: UploadsAPI.Uploads;
    /**
     * Upload a new file.
     *
     * Args: file: The file to upload.
     *
     * Returns: FileResponse: The response containing the details of the uploaded file.
     */
    create(body: FileCreateParams, options?: RequestOptions): APIPromise<FileObject>;
    /**
     * Retrieve details of a specific file by its ID.
     *
     * Args: file_id: The ID of the file to retrieve.
     *
     * Returns: FileResponse: The response containing the file details.
     */
    retrieve(fileID: string, options?: RequestOptions): APIPromise<FileObject>;
    /**
     * Update the details of a specific file.
     *
     * Args: file_id: The ID of the file to update. file: The new details for the file.
     *
     * Returns: FileObject: The updated file details.
     */
    update(fileID: string, body: FileUpdateParams, options?: RequestOptions): APIPromise<FileObject>;
    /**
     * List all files for the authenticated user.
     *
     * Args: pagination: The pagination options
     *
     * Returns: A list of files belonging to the user.
     */
    list(query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FileObjectsCursor, FileObject>;
    /**
     * Delete a specific file by its ID.
     *
     * Removes the file from every store that references it (cleaning up chunks and
     * store stats) before deleting the file object itself.
     *
     * Args: file_id: The ID of the file to delete.
     *
     * Returns: FileDeleted: The response containing the details of the deleted file.
     */
    delete(fileID: string, options?: RequestOptions): APIPromise<FileDeleteResponse>;
    /**
     * Download a specific file by its ID.
     *
     * Args: file_id: The ID of the file to download.
     *
     * Returns: FileStreamResponse: The response containing the file to be downloaded.
     */
    content(fileID: string, options?: RequestOptions): APIPromise<Response>;
}
declare const Files_base: (new (...args: any[]) => FileHelpers) & typeof FilesBase;
export declare class Files extends Files_base {
}
export type FileObjectsCursor = Cursor<FileObject>;
/**
 * A model representing a file object in the system.
 *
 * This model contains metadata about files stored in the system, including
 * identifiers, size information, and timestamps.
 */
export interface FileObject {
    /**
     * Unique identifier for the file
     */
    id: string;
    /**
     * Name of the file including extension
     */
    filename: string;
    /**
     * Size of the file in bytes
     */
    bytes: number;
    /**
     * MIME type of the file
     */
    mime_type: string;
    /**
     * Version of the file
     */
    version: number;
    /**
     * Timestamp when the file was created
     */
    created_at: string;
    /**
     * Timestamp when the file was last updated
     */
    updated_at: string;
}
/**
 * Pagination model that includes total count of items.
 */
export interface PaginationWithTotal {
    /**
     * Maximum number of items to return per page
     */
    limit?: number;
    /**
     * Offset of the first item to return
     */
    offset?: number;
    /**
     * Total number of items available
     */
    total?: number;
}
export interface FileDeleteResponse {
    /**
     * The ID of the deleted file
     */
    id: string;
    /**
     * Whether the file was deleted
     */
    deleted?: boolean;
    /**
     * The type of the deleted object
     */
    object?: 'file';
}
export interface FileCreateParams {
    /**
     * The file to upload
     */
    file: Uploadable;
}
export interface FileUpdateParams {
    /**
     * The file to update
     */
    file: Uploadable;
}
export interface FileListParams extends CursorParams {
    /**
     * Search query for fuzzy matching over name and description fields
     */
    q?: string | null;
}
export declare namespace Files {
    export { type FileObject as FileObject, type PaginationWithTotal as PaginationWithTotal, type FileDeleteResponse as FileDeleteResponse, type FileObjectsCursor as FileObjectsCursor, type FileCreateParams as FileCreateParams, type FileUpdateParams as FileUpdateParams, type FileListParams as FileListParams, type FileCreateParamsWithMultipart as FileCreateParamsWithMultipart, type FileHelpers as FileHelpers, };
    export { Uploads as Uploads, type MultipartUploadPart as MultipartUploadPart, type MultipartUploadPartURL as MultipartUploadPartURL, type UploadCreateResponse as UploadCreateResponse, type UploadRetrieveResponse as UploadRetrieveResponse, type UploadListResponse as UploadListResponse, type UploadAbortResponse as UploadAbortResponse, type UploadCreateParams as UploadCreateParams, type UploadCompleteParams as UploadCompleteParams, };
}
//# sourceMappingURL=files.d.ts.map