import { S3Client } from '@aws-sdk/client-s3';
import { Adapter } from '../index.js';

interface DigitalOceanSpacesAdapterOptions {
    bucket: string;
    /**
     * Spaces datacenter region, e.g. `"nyc3"`, `"sfo3"`, `"ams3"`, `"fra1"`,
     * `"sgp1"`, `"syd1"`, `"blr1"`, `"tor1"`, `"lon1"`. Drives the endpoint
     * host; there's no env-var fallback (no `DO_REGION` convention).
     */
    region: string;
    /**
     * Override the Spaces endpoint. When unset, defaults to
     * `https://${region}.digitaloceanspaces.com`. Spaces routes by Host header
     * — the SDK prepends the bucket subdomain for virtual-hosted style.
     */
    endpoint?: string;
    accessKeyId?: string;
    secretAccessKey?: string;
    /**
     * Use path-style addressing (`/<bucket>/<key>`) rather than virtual-hosted
     * style. Defaults to `false` — virtual-hosted is canonical for Spaces.
     */
    forcePathStyle?: boolean;
    /**
     * Origin used to build URLs from `url()`. When set, `url(key)` returns
     * `${publicBaseUrl}/${key}` and skips signing — typical values are the
     * Spaces CDN host (`https://${bucket}.${region}.cdn.digitaloceanspaces.com`)
     * or a custom CNAME. When unset, `url()` falls back to a presigned
     * GetObject (default expiry: 1 hour).
     */
    publicBaseUrl?: string;
    /**
     * Default expiry, in seconds, for the presigned URLs returned by `url()`
     * when `publicBaseUrl` is not set. Defaults to 3600 (1 hour).
     */
    defaultUrlExpiresIn?: number;
}
type DigitalOceanSpacesAdapter = Adapter<S3Client>;
declare const digitaloceanSpaces: (opts: DigitalOceanSpacesAdapterOptions) => DigitalOceanSpacesAdapter;

export { type DigitalOceanSpacesAdapter, type DigitalOceanSpacesAdapterOptions, digitaloceanSpaces };