import type { Adapter } from "../index.js";
import { FilesError } from "../internal/errors.js";
export interface BunS3OperationOptions {
    bucket?: string;
    region?: string;
    accessKeyId?: string;
    secretAccessKey?: string;
    sessionToken?: string;
    endpoint?: string;
    virtualHostedStyle?: boolean;
    type?: string;
    contentDisposition?: string;
}
export interface BunS3PresignOptions extends BunS3OperationOptions {
    expiresIn?: number;
    method?: "GET" | "POST" | "PUT" | "DELETE" | "HEAD";
}
export interface BunS3Stats {
    size: number;
    lastModified: Date;
    etag: string;
    type: string;
}
export interface BunS3ListObjectsOptions {
    prefix?: string;
    continuationToken?: string;
    delimiter?: string;
    maxKeys?: number;
    startAfter?: string;
    encodingType?: "url";
    fetchOwner?: boolean;
}
export interface BunS3ListObjectsResponse {
    contents?: {
        eTag?: string;
        key: string;
        lastModified?: string | Date;
        size?: number;
    }[];
    isTruncated?: boolean;
    nextContinuationToken?: string;
}
export type BunS3WritableBody = string | ArrayBuffer | ArrayBufferView | Blob | Request | Response;
export interface BunS3FileLike {
    bytes?(): Promise<Uint8Array>;
    arrayBuffer(): Promise<ArrayBuffer>;
    stream(): ReadableStream<Uint8Array>;
    stat(): Promise<BunS3Stats>;
    /**
     * Bun's `S3File.slice(begin, end)` — `Blob`-style, so `end` is exclusive.
     * Returns a handle that fetches only that byte range when read. Used to
     * honor {@link DownloadOptions.range}.
     */
    slice(begin?: number, end?: number, contentType?: string): BunS3FileLike;
}
export interface BunS3ClientLike {
    file(path: string): BunS3FileLike;
    write(path: string, data: BunS3WritableBody, options?: BunS3OperationOptions): Promise<number>;
    delete(path: string): Promise<void>;
    exists(path: string): Promise<boolean>;
    stat(path: string): Promise<BunS3Stats>;
    list(input?: BunS3ListObjectsOptions | null): Promise<BunS3ListObjectsResponse>;
    presign(path: string, options?: BunS3PresignOptions): string;
}
export interface BunS3AdapterOptions {
    /**
     * A pre-configured `Bun.S3Client`-shaped instance — for example the global
     * `Bun.s3`, or one constructed with specific credentials elsewhere in your
     * app. When set, the adapter uses it as-is and rejects any of `bucket`,
     * `region`, `endpoint`, `virtualHostedStyle`, `accessKeyId`,
     * `secretAccessKey`, `sessionToken` at construction (they would be silently
     * ignored otherwise). When unset, the adapter constructs its own client
     * from the options below.
     */
    client?: BunS3ClientLike;
    /**
     * S3 bucket name. Scopes operations and is exposed as `adapter.bucket`.
     * Falls back to `S3_BUCKET` / `AWS_BUCKET` via Bun's built-in resolution.
     */
    bucket?: string;
    /**
     * AWS region (e.g. `us-east-1`). Falls back to `S3_REGION` / `AWS_REGION`
     * via Bun's resolution.
     */
    region?: string;
    /**
     * Override the S3 service endpoint. Use this to point at S3-compatible
     * services (R2, DigitalOcean Spaces, Wasabi, MinIO, ...).
     */
    endpoint?: string;
    /**
     * Use virtual-hosted-style addressing (`https://<bucket>.<endpoint>`)
     * instead of path-style. Defaults to `false` — flip on for endpoints that
     * require it.
     */
    virtualHostedStyle?: boolean;
    /**
     * Static access key ID. Skip to let Bun resolve it from
     * `S3_ACCESS_KEY_ID` / `AWS_ACCESS_KEY_ID`.
     */
    accessKeyId?: string;
    /**
     * Static secret access key. Skip to let Bun resolve it from
     * `S3_SECRET_ACCESS_KEY` / `AWS_SECRET_ACCESS_KEY`.
     */
    secretAccessKey?: string;
    /**
     * Static session token for temporary credentials. Skip to let Bun resolve
     * it from `S3_SESSION_TOKEN` / `AWS_SESSION_TOKEN`.
     */
    sessionToken?: string;
    /**
     * Origin used to build URLs from `url()`. When set, `url(key)` returns
     * `${publicBaseUrl}/${key}` and skips signing — use this if your bucket is
     * fronted by a CDN or has a public-read policy. Passing
     * `responseContentDisposition` still forces a signed URL even when this is
     * set, because a permanent CDN URL has no signature in which to bind the
     * override. When unset, `url()` returns a presigned GetObject (1-hour
     * default).
     */
    publicBaseUrl?: string;
    /**
     * Default expiry, in seconds, for the presigned URLs returned by `url()`
     * when `publicBaseUrl` isn't set. Defaults to 3600 (1 hour). Per-call
     * `url(key, { expiresIn })` overrides.
     */
    defaultUrlExpiresIn?: number;
}
export type BunS3Adapter = Adapter<BunS3ClientLike> & {
    readonly bucket?: string;
};
export declare const mapBunS3Error: (err: unknown) => FilesError;
export declare const bunS3: (opts?: BunS3AdapterOptions) => BunS3Adapter;
//# sourceMappingURL=index.d.ts.map