import type { ChecksumOptions, DirectoryListing, FileContents, GetStreamOptions, ListOptions, MimeTypeOptions, PresignedUploadPolicy, PresignedUploadPolicyOptions, PresignedUploadUrl, PresignedUploadUrlOptions, PublicUrlOptions, PutResult, PutStreamOptions, SignedUrlOptions, StatEntry, StorageAdapter, TemporaryUrlOptions, Visibility } from '../types';
/**
 * Convenience factory — most app code reads cleaner with the
 * function form than `new ScopedStorageAdapter(...)`.
 *
 * @example
 * ```ts
 * const tenantDisk = scoped(Storage.disk('s3'), { scope: `tenant-${id}` })
 * ```
 */
export declare function scoped(inner: StorageAdapter, options: ScopedAdapterOptions): ScopedStorageAdapter;
/**
 * Configuration for a scoped adapter.
 */
export declare interface ScopedAdapterOptions {
  scope: string
  scopePattern?: RegExp
}
/**
 * Wrap any `StorageAdapter` to scope every operation under a
 * per-tenant prefix. The wrapped instance presents the same
 * `StorageAdapter` interface so the session middleware /
 * `Storage.disk()` / cross-disk copy all work transparently.
 *
 * Construction validates the scope against
 * {@link ScopedAdapterOptions.scopePattern} so a hostile or
 * malformed tenant id can't escape via `..` segments or path
 * separators.
 *
 * @example
 * ```ts
 * const tenantDisk = new ScopedStorageAdapter(
 *   Storage.disk('s3'),
 *   { scope: `tenant-${tenantId}` },
 * )
 * await tenantDisk.write('avatar.jpg', file)  // → tenant-42/avatar.jpg
 * ```
 */
export declare class ScopedStorageAdapter implements StorageAdapter {
  constructor(inner: StorageAdapter, options: ScopedAdapterOptions);
  write(path: string, contents: FileContents): Promise<PutResult>;
  read(path: string): Promise<FileContents>;
  readToString(path: string): Promise<string>;
  readToBuffer(path: string): Promise<Buffer>;
  readToUint8Array(path: string): Promise<Uint8Array>;
  deleteFile(path: string): Promise<void>;
  deleteDirectory(path: string): Promise<void>;
  createDirectory(path: string): Promise<void>;
  moveFile(from: string, to: string): Promise<void>;
  copyFile(from: string, to: string): Promise<void>;
  stat(path: string): Promise<StatEntry>;
  list(path: string, options?: ListOptions): DirectoryListing;
  changeVisibility(path: string, visibility: Visibility): Promise<void>;
  visibility(path: string): Promise<Visibility>;
  fileExists(path: string): Promise<boolean>;
  directoryExists(path: string): Promise<boolean>;
  publicUrl(path: string, options?: PublicUrlOptions): Promise<string>;
  temporaryUrl(path: string, options: TemporaryUrlOptions): Promise<string>;
  signedUrl(path: string, options: SignedUrlOptions): Promise<string>;
  presignedUploadUrl(options: PresignedUploadUrlOptions): Promise<PresignedUploadUrl>;
  presignedUploadPolicy(options: PresignedUploadPolicyOptions): Promise<PresignedUploadPolicy>;
  getStream(path: string, options?: GetStreamOptions): Promise<ReadableStream<Uint8Array>>;
  putStream(path: string, stream: ReadableStream<Uint8Array>, options?: PutStreamOptions): Promise<PutResult>;
  checksum(path: string, options?: ChecksumOptions): Promise<string>;
  mimeType(path: string, options?: MimeTypeOptions): Promise<string>;
  lastModified(path: string): Promise<number>;
  fileSize(path: string): Promise<number>;
}