/* ============================================================
 * Copyright (c) 2026 RAVAPI Soluções. www.ravapi.com
 * Storage de assets — interface (docs/decisoes.md §16: S3-compatível)
 *
 * A interface não sabe que é S3. Isso é o que deixa o modo embarcado
 * (docs/escopo.md §4) livre para rodar num provedor diferente do host
 * sem tocar em CadastrosService/VerificacaoService.
 * ============================================================ */

export interface StorageAdapter {
  salvar(chave: string, bytes: Buffer, mime: string): Promise<void>;
  /** URL pública e estável para a chave — não assinada: o bucket serve direto. */
  urlPublica(chave: string): string;
}