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

interface YandexAdapterOptions {
    bucket: string;
    /**
     * Override the Yandex Object Storage endpoint. Defaults to
     * `https://storage.yandexcloud.net` — Yandex serves a single global
     * endpoint and routes internally. Override for a private deployment or
     * proxy.
     */
    endpoint?: string;
    accessKeyId?: string;
    secretAccessKey?: string;
    /**
     * SigV4 region used for signing. Defaults to `"ru-central1"` — Yandex's
     * only public region today. The value is required by the signature but
     * doesn't drive routing (the endpoint is fixed). Leave the default unless
     * you have a reason to change it.
     */
    region?: string;
    /**
     * Use path-style addressing (`/<bucket>/<key>`) rather than virtual-hosted
     * style. Defaults to `false` — virtual-hosted is canonical for Yandex
     * Object Storage.
     */
    forcePathStyle?: boolean;
    /**
     * Origin used to build URLs from `url()`. When set, `url(key)` returns
     * `${publicBaseUrl}/${key}` and skips signing. For public buckets the
     * natural value is `https://${bucket}.storage.yandexcloud.net`; a custom
     * domain bound to the bucket also works. 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 YandexAdapter = Adapter<S3Client>;
declare const yandex: (opts: YandexAdapterOptions) => YandexAdapter;

export { type YandexAdapter, type YandexAdapterOptions, yandex };